如何在openpyxl插入首行后更新名称管理器的列定义名称？

当你用ws.insert_rows(2)在表头下方插入新行后，可以通过操作openpyxl的defined_names对象来更新名称管理器里的列范围，具体实现如下：

1. 核心逻辑 #

遍历工作簿中所有定义的名称，筛选出目标工作表（如Sample）内以第2行为起始行的单列范围名称，将其结束行号加1，让范围自动包含新插入的行。

2. 完整代码示例 #

from openpyxl import load_workbook
from openpyxl.utils import range_boundaries

# 加载目标工作簿
wb = load_workbook("你的工作簿路径.xlsx")
ws = wb["Sample"]

# 执行插入行并填充数据（你的现有代码）
ws.insert_rows(2)
# 示例填充新行数据
ws["A2"] = "新样本ID"
ws["B2"] = "新样本描述"

# 更新名称管理器的范围
target_sheet = "Sample"
data_start_row = 2  # 数据起始行（表头为第1行）

for name in wb.defined_names.definedName:
    # 获取名称对应的所有目标位置
    for sheet_name, coord in name.destinations:
        if sheet_name == target_sheet:
            # 解析单元格范围的边界：最小列、最小行、最大列、最大行
            min_col, min_row, max_col, max_row = range_boundaries(coord)
            # 筛选出单列且起始行匹配的名称
            if min_col == max_col and min_row == data_start_row:
                # 扩展结束行号
                new_max_row = max_row + 1
                # 构造新的范围坐标
                new_coord = f"{ws.cell(row=min_row, column=min_col).coordinate}:{ws.cell(row=new_max_row, column=max_col).coordinate}"
                # 更新名称的引用内容
                name.attr_text = f"={target_sheet}!{new_coord}"

# 保存修改后的工作簿
wb.save("更新后的工作簿路径.xlsx")

3. 关键代码说明 #

• range_boundaries(coord)：解析单元格范围字符串，返回四个边界值，方便快速判断范围类型并修改。
• name.attr_text：直接修改名称管理器中"Refers To"的内容，格式需遵循=工作表名!单元格范围的Excel规则。
• 筛选条件：确保只处理目标工作表、单列、起始行正确的名称，避免误修改其他无关的定义名称。

4. 扩展场景 #

如果需要插入多行（如ws.insert_rows(2, amount=3)），只需将new_max_row = max_row + amount即可批量扩展范围。

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