使用openpyxl创建Excel表格：表头上方加行致文件损坏的解决求助

两种可行实现方式 #

方式一：创建表格时直接预留前置行 #

最稳妥的方式是在生成表格阶段就规划好结构，先写入表头上方的内容，再设置表头，避免后续修改时出现文件损坏问题。

from openpyxl import Workbook
from openpyxl.styles import Font, Alignment, PatternFill

# 初始化工作簿和工作表
wb = Workbook()
ws = wb.active

# 写入表头上方的两行内容
ws["A1"] = "报表标题"
ws["B1"] = "2024年度"
ws["A2"] = "备注：数据统计截止至2024-06-30"

# 定义表头并写入第三行
header = ["员工ID", "姓名", "入职日期", "部门", "薪资"]
for col_idx, title in enumerate(header, 1):
    cell = ws.cell(row=3, column=col_idx, value=title)
    # 设置表头样式
    cell.font = Font(bold=True, color="FFFFFF")
    cell.fill = PatternFill(start_color="4F81BD", end_color="4F81BD", fill_type="solid")
    cell.alignment = Alignment(horizontal="center")

# 填充示例数据
data = [
    ["E001", "张三", "2022-03-15", "技术部", 8000],
    ["E002", "李四", "2021-09-01", "市场部", 7500]
]
for row_idx, row_data in enumerate(data, 4):
    for col_idx, value in enumerate(row_data, 1):
        ws.cell(row=row_idx, column=col_idx, value=value)

# 保存文件
wb.save("带前置行的员工报表.xlsx")

方式二：加载已有表格后安全插入前置行 #

如果必须修改已存在的表格，需确保使用openpyxl的标准插入方法，同时规避可能导致损坏的操作：

from openpyxl import load_workbook
from openpyxl.styles import Font, Alignment, PatternFill

# 加载已有的表格文件（表头位于第一行）
wb = load_workbook("原员工报表.xlsx")
ws = wb.active

# 在第1行位置插入2行，原表头会自动下移到第3行
ws.insert_rows(idx=1, amount=2)

# 填充新插入的前置行内容
ws["A1"] = "报表标题"
ws["B1"] = "2024年度"
ws["A2"] = "备注：数据统计截止至2024-06-30"

# 重新设置表头样式（可选，确保样式不丢失）
header_row = 3
for cell in ws[header_row]:
    cell.font = Font(bold=True, color="FFFFFF")
    cell.fill = PatternFill(start_color="4F81BD", end_color="4F81BD", fill_type="solid")
    cell.alignment = Alignment(horizontal="center")

# 保存为新文件，避免覆盖原文件导致数据丢失
wb.save("修改后员工报表.xlsx")

可能导致文件损坏的原因及规避方法 #

• 版本兼容问题：使用旧版本openpyxl处理新版Excel格式，建议升级到最新版：pip install --upgrade openpyxl
• 文件锁定：在Excel打开文件的状态下执行保存操作，需确保文件已关闭
• 复杂元素不支持：原文件包含宏、透视表、复杂公式等openpyxl不完全支持的元素，这类场景建议提前规划结构，避免后期修改
• 样式冲突：插入行后原有的单元格样式、合并单元格逻辑混乱，可通过重新设置样式或提前预留行来避免

内容的提问来源于stack exchange，提问作者mabusdogma