Install
openclaw skills install excel-multi-table-mergeExcel多表格合并工具
将工作簿中的多个表格合并为一个表格，基于指定的两列（项目名称及特征、生产规格）进行匹配汇总，合计件数和数量。
Excel多表格合并工具
简介
将工作簿中的多个表格合并为一个表格，基于指定的两列（项目名称及特征、生产规格）进行匹配汇总，合计件数和数量。
功能特性
- 自动识别各工作表的表头结构
- 基于两列完全一致的数据进行合并汇总
- 支持按关键字（梁、柱、档、板、椽、枋、机、戗）排序
- 自动过滤支架、膨胀、螺丝、镀锌等无关项目
- 读取公式计算结果（而非公式本身）
使用场景
当用户要求将Excel工作簿中的多个发货清单/统计表合并时使用。
核心代码
import openpyxl
from openpyxl.styles import Font, Alignment, Border, Side
from collections import defaultdict
def merge_excel_tables(input_file, output_file, ignore_keywords=None, sort_keywords=None):
"""
合并Excel多表格
参数:
input_file: 输入Excel文件路径
output_file: 输出Excel文件路径
ignore_keywords: 需要忽略的关键词列表
sort_keywords: 排序关键字优先级列表
"""
if ignore_keywords is None:
ignore_keywords = ['支架', '膨胀', '螺丝', '镀锌']
if sort_keywords is None:
sort_keywords = ['梁', '柱', '档', '板', '椽', '枋', '机', '戗']
# 1. 读取数据 - 必须使用 data_only=True 获取计算后的值
wb = openpyxl.load_workbook(input_file, data_only=True)
# 2. 用于存储合并数据
data_dict = defaultdict(lambda: {'count': [], 'qty': []})
# 3. 遍历每个工作表
for sheet_name in wb.sheetnames:
ws = wb[sheet_name]
# 找到表头行
header_row = None
for row_idx in range(1, min(15, ws.max_row + 1)):
row_values = [ws.cell(row=row_idx, column=col).value for col in range(1, 12)]
if '序号' in str(row_values[0]) or '序号' in str(row_values):
header_row = row_idx
break
if header_row is None:
continue
# 识别关键列
name_col, spec_col, count_col, qty_col = identify_columns(ws, header_row)
# 遍历数据行
process_data_rows(ws, header_row, name_col, spec_col, count_col, qty_col,
data_dict, ignore_keywords)
wb.close()
# 4. 排序
sorted_items = sorted(data_dict.items(), key=lambda x: get_sort_key(x, sort_keywords))
# 5. 创建新工作簿并写入
write_output(sorted_items, output_file)
def identify_columns(ws, header_row):
"""识别关键列索引"""
name_col = spec_col = count_col = qty_col = None
for col in range(1, ws.max_column + 1):
header = ws.cell(row=header_row, column=col).value
if header:
header_str = str(header).strip()
if '项目名称' in header_str or '部件名称' in header_str:
name_col = col
elif '生产规格' in header_str:
spec_col = col
elif header_str == '件':
count_col = col
elif '数量' in header_str and ('M)' in header_str or 'm)' in header_str):
qty_col = col
# 备用方案
if name_col is None: name_col = 2
if spec_col is None: spec_col = 4
return name_col, spec_col, count_col, qty_col
def process_data_rows(ws, header_row, name_col, spec_col, count_col, qty_col,
data_dict, ignore_keywords):
"""处理数据行"""
skip_keywords = ['包装', '合计', '税金', '总计', '说明', '甲方',
'现场', '施工', '制单人']
start_row = header_row + 1
for row_idx in range(start_row, ws.max_row + 1):
name = ws.cell(row=row_idx, column=name_col).value
spec = ws.cell(row=row_idx, column=spec_col).value
name_str = str(name).strip() if name else ''
spec_str = str(spec).strip() if spec else ''
# 跳过空行
if not name_str and not spec_str:
continue
# 过滤关键词
if name_str and any(kw in name_str for kw in ignore_keywords):
continue
if spec_str and any(kw in spec_str for kw in ignore_keywords):
continue
# 跳过无效行
if name_str and any(kw in name_str for kw in skip_keywords):
continue
# 获取件数和数量
count = get_numeric_value(ws.cell(row=row_idx, column=count_col).value) if count_col else 0
qty = get_numeric_value(ws.cell(row=row_idx, column=qty_col).value) if qty_col else 0
if count > 0 or qty > 0:
key = (name_str if name_str else spec_str, spec_str if spec_str else name_str)
if count > 0:
data_dict[key]['count'].append(count)
if qty > 0:
data_dict[key]['qty'].append(qty)
def get_numeric_value(value):
"""获取数值"""
if isinstance(value, (int, float)):
return value
if value is None or value == '':
return 0
return 0
def get_sort_key(item, sort_keywords):
"""排序键"""
name = item[0][0].lower()
for i, keyword in enumerate(sort_keywords):
if keyword in name:
return (i, name, item[0][1])
return (len(sort_keywords), name, item[0][1])
def write_output(sorted_items, output_file):
"""写入输出文件"""
new_wb = openpyxl.Workbook()
ws = new_wb.active
ws.title = "合并清单"
# 表头
headers = ['序号', '项目名称及特征', '生产规格', '合计件数', '合计数量']
for col, header in enumerate(headers, 1):
cell = ws.cell(row=1, column=col, value=header)
cell.font = Font(bold=True)
cell.alignment = Alignment(horizontal='center', vertical='center')
# 边框样式
thin_border = Border(
left=Side(style='thin'), right=Side(style='thin'),
top=Side(style='thin'), bottom=Side(style='thin')
)
# 写入数据
for idx, (key, data) in enumerate(sorted_items, 1):
total_count = sum(data['count'])
total_qty = sum(data['qty'])
ws.cell(row=idx+1, column=1, value=idx)
ws.cell(row=idx+1, column=2, value=key[0])
ws.cell(row=idx+1, column=3, value=key[1])
ws.cell(row=idx+1, column=4, value=int(total_count) if total_count == int(total_count) else round(total_count, 2) if total_count > 0 else '')
ws.cell(row=idx+1, column=5, value=round(total_qty, 2) if total_qty > 0 else '')
for col in range(1, 6):
ws.cell(row=idx+1, column=col).border = thin_border
# 调整列宽
ws.column_dimensions['A'].width = 8
ws.column_dimensions['B'].width = 35
ws.column_dimensions['C'].width = 30
ws.column_dimensions['D'].width = 15
ws.column_dimensions['E'].width = 15
new_wb.save(output_file)
# 使用示例
if __name__ == "__main__":
input_file = "user_input_files/发货清单.xlsx"
output_file = "/workspace/合并发货清单汇总.xlsx"
merge_excel_tables(input_file, output_file)
print(f"已合并 {len(data_dict)} 个不同项目")
关键注意事项
⚠️ 重要：data_only=True
必须使用 data_only=True 读取Excel文件，否则会读到公式字符串（如 =F5*3）而非计算结果。
# ✅ 正确：读取计算后的值
wb = openpyxl.load_workbook(file, data_only=True)
# ❌ 错误：读到公式字符串
wb = openpyxl.load_workbook(file)
列识别
不同工作表的列位置可能不同，需要根据表头动态识别：
- 项目名称列：表头包含"项目名称"或"部件名称"
- 生产规格列：表头包含"生产规格"
- 件数列：表头为"件"
- 数量列：表头包含"数量"和"M)"或"m)"
数据过滤
自动过滤：
- 忽略词：
支架、膨胀、螺丝、镀锌 - 跳过行：
包装、合计、税金、总计、说明、甲方、现场、施工
输出文件
生成的Excel文件包含5列：
| 列 | 说明 |
|---|---|
| A | 序号 |
| B | 项目名称及特征 |
| C | 生产规格 |
| D | 合计件数 |
| E | 合计数量 |