使用openpyxl向带表格的Excel插入行后文件损坏无法读取如何解决

openpyxl 提供的原生insert_rows方法仅会调整单元格的位置，不会同步更新工作表中已定义的**结构化表格（Excel List Object）**的边界引用范围。Excel打开文件时会校验表格配置的范围与实际单元格分布的一致性，两者不匹配就会触发文件损坏、需要修复的提示。

最简便的处理方式是插入行后手动更新所有结构化表格的引用范围，修改后的完整代码如下：

import openpyxl

excel_file_name = "替换为你的Excel文件路径"
wb = openpyxl.load_workbook(excel_file_name)
sheet = wb['Sheet1']

insert_start = 1 # 插入行的起始位置
insert_num = 10 # 插入的行数
sheet.insert_rows(insert_start, amount=insert_num)

# 同步更新工作表内所有结构化表格的范围
for table in sheet.tables.values():
    start_coord, end_coord = table.ref.split(":")
    # 解析原表格的起止行号
    _, start_row = openpyxl.utils.coordinate_from_string(start_coord)
    end_col, end_row = openpyxl.utils.coordinate_from_string(end_coord)
    # 插入位置在表格范围内或表格上方时，更新表格范围
    if insert_start <= end_row:
        new_end_row = end_row + insert_num
        table.ref = f"{start_coord}:{end_col}{new_end_row}"

wb.save(excel_file_name)
wb.close()

如果不需要保留结构化表格的筛选、样式等属性，也可以先在Excel里把表格转换为普通单元格区域，再运行原来的代码，不会触发修复提示。

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