excel_diff Skill
比对两份 Excel,输出单元格级差异,可导出差异表
功能描述
把两份 Excel 的同一张工作表做对比,返回每个变化的单元格、新增行、删除行和表头变化。 支持两种模式:按行号逐格比对(适合行顺序固定的表),或按主键配对后再比对 (适合行顺序会变、但每行有唯一编号的表)。
所属分类
skills/excel/excel_diff/
调用方式
from skills.excel import excel_diff
excel_diff(
before_path='上周报表.xlsx',
after_path='本周报表.xlsx',
key_column='订单号',
)
参数说明
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
before_path |
str | 是 | - | 变更前的 Excel 路径 |
after_path |
str | 是 | - | 变更后的 Excel 路径 |
sheet_name |
str | 否 | None |
工作表名,默认取第一个 |
key_column |
str | 否 | None |
主键列名;指定后按主键配对行 |
ignore_case |
bool | 否 | False |
文本比较是否忽略大小写 |
output_path |
str | 否 | None |
差异表输出路径,指定后写出 .xlsx |
返回值
dict,包含 mode、sheet、header、summary、changes、added_rows、
removed_rows、output_path 八个键。summary 中的 identical 表示两份表是否完全一致。
使用示例
from skills.excel import excel_diff
result = excel_diff('v1.xlsx', 'v2.xlsx', key_column='编号', output_path='差异.xlsx')
print(result['summary'])
for item in result['changes']:
print(item['key'], item['column'], item['before'], '->', item['after'])
原始函数
contributors/my12yyds/excel_diff.py
