用途:把表格数据、查询结果或分析输出导出为 .xlsx,用于生成报表、仪表盘、财务模型,以及为重复流程创建模板化 Excel。
主要能力:使用 openpyxl 可读写和修改现有 Excel 文件、支持公式、命名样式、多工作表、条件格式、图表等完整功能;使用 xlsxwriter 为只写模式,面向大数据集性能更好,图表与格式 API 更丰富。两者均支持公式、图表、条件格式与表格(ListObject)。实际行数上 openpyxl 约 10 万行,xlsxwriter 可达数百万行。
必要用法:安装执行 pip install openpyxl xlsxwriter,或 uv add openpyxl xlsxwriter。选择原则是读取或修改现有文件用 openpyxl,创建大型新文件用 xlsxwriter。生成文件保存到用户指定路径,或代理生成报告时保存到 .claude/context/artifacts/。
适用场景:Excel 导出、报表生成、数据分析结果转换、跨工作表汇总、条件高亮、柱状图等图表、自动筛选与冻结首行。
限制与注意:openpyxl 的 write_only 模式写入后无法回读单元格;xlsxwriter 必须调用 workbook.close(),否则文件不会落盘;数字应使用原生 int/float 而非字符串;大数据集不应逐单元格用 openpyxl 写入,应使用 xlsxwriter 的 write_row;自动列宽计算时避免残留合并单元格,否则会触发 AttributeError。具体库版本细节与性能模式暂未提供。