用途:创建、编辑和分析 .xlsx 文件,覆盖数据读写、公式、格式、数据分析与可视化。
主要能力:用 pandas 读取、分析、导出数据;用 openpyxl 创建/编辑工作簿、写公式、设置字体填充对齐与列宽、多工作表操作;以 recalc.py 重算公式并扫描全部单元格的 Excel 错误(#REF!、#DIV/0!、#VALUE!、#NAME?、#N/A)。
必要用法:数据分析用 pandas,公式与格式用 openpyxl;所有计算应写为 Excel 公式而非 Python 硬编码结果,例如 sheet['B10'] = '=SUM(B2:B9)'。修改文件后若含公式,必须运行 python recalc.py output.xlsx(可加超时秒数),脚本返回 JSON 含状态、错误总数、公式数与错误位置;若 status 为 errors_found,按 error_summary 定位修复后重算。
适用场景:财务报表与财务模型、模板更新、批量数据处理与可视化。
限制与规范:需 LibreOffice 支持重算,首次运行自动配置;openpyxl 写入的公式仅以字符串保存、不计算公式值;data_only=True 读取并保存会永久丢失公式;文件更新模板时须保留原格式与约定;公式错误为零,负数用括号,年份按文本,货币标单位,假设值放入独立单元格并用引用;硬编码值需注明来源。