本文介绍如何利用 openpyxl 高效合并具有相同 id（列 a）的多行数据，将对应列（如列 i）的文本拼接为单个字符串，并写入新工作表，避免循环索引错误与原地修改陷阱。
本文介绍如何利用 openpyxl 高效合并具有相同 id（列 a）的多行数据，将对应列（如列 i）的文本拼接为单个字符串，并写入新工作表，避免循环索引错误与原地修改陷阱。
在处理结构化 Excel 数据时，常遇到“一对多”场景：同一 ID（如列 A）重复出现，而需将其关联的描述性文本（如列 I）合并为一条完整记录。直接遍历相邻单元格判断相等性易出错（如边界越界、重复拼接、赋值目标不明确），且原地修改会干扰后续迭代。更健壮的做法是以 ID 为键构建字典，累积拼接文本，再统一输出到新工作表。
以下是一个完整、可运行的解决方案：
import openpyxl
# 加载工作簿与活动工作表
wb = openpyxl.load_workbook('Book1.xlsx')
ws = wb.active
# 步骤 1：构建 ID → 合并文本的映射字典
id_to_text = {}
for cell in ws['A']:
if cell.row == 1 and not cell.value: # 跳过空首行（可选）
continue
id_val = cell.value
# 使用 offset(column=8) 获取同一行的列 I（A=0, B=1, ..., I=8）
text_val = cell.offset(column=8).value
# 安全转换为字符串，跳过 None 值
text_str = str(text_val) if text_val is not None else ""
if id_val in id_to_text:
# 拼接时添加空格分隔（可根据需求改为换行符 '\n' 或其他分隔符）
id_to_text[id_val] += f" {text_str}"
else:
id_to_text[id_val] = text_str
# 步骤 2：创建新工作表用于输出结果
ws_combined = wb.create_sheet("Combined")
# 步骤 3：逐行写入合并结果（ID 到列 A，合并文本到列 I）
for id_key, merged_text in id_to_text.items():
# 写入第 1 列（A）和第 9 列（I），中间插入 7 列占位（B–H）
ws_combined.append([str(id_key)]) # 先写 ID 到 A 列
# 将合并文本写入该行的 I 列（即第 9 列）
ws_combined.cell(row=ws_combined.max_row, column=9, value=merged_text)
# 可选：自动调整列宽提升可读性
ws_combined.column_dimensions['A'].width = 12
ws_combined.column_dimensions['I'].width = 50
# 保存结果
wb.save('Book1_merged.xlsx')
✅ 关键优势说明：
- 无需手动管理行号或计数器：字典天然聚合相同 key 的所有值，规避 mergecount 和 startcell 的逻辑漏洞；
- 安全容错：显式检查 None 值并转为字符串，防止 TypeError；
- 灵活分隔：f" {text_str}" 可轻松替换为 f"\n{text_str}" 实现换行拼接；
- 非破坏性操作：结果写入全新工作表，原始数据完整保留，符合生产环境最佳实践；
- 列定位精准：cell.offset(column=8) 明确指向列 I（A 是 column=0），比硬编码列索引更清晰可靠。
⚠️ 注意事项：
- 若原始数据含标题行，请在循环中添加 if cell.row == 1: continue 跳过；
- 如需保留 B–H 列数据，本方案需扩展逻辑（例如按 ID 同时聚合多列），但核心字典模式依然适用；
- 大文件处理时，可考虑使用 read_only=True 加载只读工作簿以提升性能（但此时不支持写入，需另建输出工作簿）。
通过该方法，您能稳定、可维护地完成“按 ID 合并文本”任务，代码简洁、意图明确，适合集成进自动化数据清洗流程。
