Python使用openpyxl向Excel工作表插入空列异常如何解决

• 代码存在拼写错误：调用的sheet.inset_cols(185)方法名错误，正确方法名为insert_cols，缺失字母r会直接触发方法不存在报错。
• 窄列插入异常本质：openpyxl旧版本（3.1.0以前）执行列插入时，列维度（列宽、样式等）的索引偏移逻辑存在bug：如果插入位置紧邻的后一列是手动设置了极小宽度的列，且该列的列维度属性不完整，偏移计算时会出现属性映射错位，要么把后一列的窄宽度错误赋值给新列，要么触发列维度越界报错。两个标准宽度列之间插入时，因为两侧列的维度属性完整，不会触发该bug。

修复拼写问题，插入列后主动重置新列的列维度属性，避免被后方窄列的异常属性污染，代码如下：

from openpyxl import load_workbook
from copy import copy

# 加载时保留所有原有格式、公式
wb = load_workbook('file.xlsx', data_only=False)
sheet = wb.worksheets[8]
insert_col_idx = 185

# 修正方法名，执行单空列插入
sheet.insert_cols(insert_col_idx)

# 主动设置新列的标准宽度，重置列维度
new_col_letter = sheet.cell(row=1, column=insert_col_idx).column_letter
new_col_dim = sheet.column_dimensions[new_col_letter]
new_col_dim.width = 8.38  # Excel默认标准列宽值

# 可选：如果需要和前一列格式保持一致，复制前一列的列样式
prev_col_letter = sheet.cell(row=1, column=insert_col_idx-1).column_letter
prev_col_dim = sheet.column_dimensions[prev_col_letter]
if prev_col_dim.has_style:
    new_col_dim.font = copy(prev_col_dim.font)
    new_col_dim.fill = copy(prev_col_dim.fill)
    new_col_dim.border = copy(prev_col_dim.border)
    new_col_dim.alignment = copy(prev_col_dim.alignment)
    new_col_dim.number_format = prev_col_dim.number_format

wb.save('file.xlsx')

额外建议：将openpyxl升级到3.1.2及以上稳定版本，新版本已经修复了列插入时维度偏移错位的已知问题。

如果运行环境安装了Microsoft Excel，优先使用xlwings库调用Excel原生接口执行插入操作，完全走Excel原生逻辑，不会出现任何格式错位、属性映射错误，对固定结构的复杂格式文件兼容性拉满，代码如下：

import xlwings as xw

# 后台启动Excel，不显示界面
app = xw.App(visible=False, add_book=False)
wb = app.books.open('file.xlsx')
sheet = wb.sheets[8]

# 调用Excel原生列插入接口，自动处理所有格式、合并单元格、数据验证的偏移
sheet.api.Columns(185).Insert()
# 按需设置新列宽度
sheet.range(1, 185).column_width = 8.38

wb.save()
wb.close()
app.quit()

• 该方案不存在openpyxl类库的格式解析bug，适配所有Excel原生规则，适合处理结构固定、不允许格式错乱的正式文件。
• 无Excel运行环境的场景，除了使用上述修复后的openpyxl方案，也可以换用win32com（仅Windows）实现相同的原生调用效果。

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