Python Openpyxl修改工作表名称时如何保持公式引用正常生效

openpyxl旧版本、废弃API调用是导致公式引用不同步的核心原因，可按自身场景选择对应方案解决：

方案1：修正openpyxl写法（推荐，无额外兼容问题） #

你代码中使用的get_sheet_by_name()是openpyxl已废弃的旧API，在部分版本中调用该方法获取的工作表对象，修改名称时不会触发工作簿内部的引用更新逻辑。同时注意加载工作簿时不能开启data_only=True参数，该参数会丢弃所有公式结构，仅保留计算结果值。
修正后的可直接运行代码：

import openpyxl
wb = openpyxl.load_workbook('/path/to/file')
ws = wb['SomeName']  # 替换废弃的get_sheet_by_name调用
ws.title = 'SomeOtherName'
wb.save('/path/to/anotherFile')
wb.close()

如果运行后仍存在引用断裂问题，直接升级openpyxl到3.0及以上版本即可，3.0后版本已经内置了修改表名时自动同步所有跨表公式引用的逻辑，升级命令：
pip install --upgrade openpyxl

方案2：手动遍历替换公式引用（兼容所有openpyxl版本） #

如果受环境限制无法升级openpyxl版本，可以在修改表名后，遍历所有工作表的公式单元格，批量替换旧表名引用。代码中已经兼容表名含空格、特殊字符时Excel自动添加单引号包裹的语法规则，不会出现公式语法错误：

import openpyxl
import re

old_name = 'SomeName'
new_name = 'SomeOtherName'

wb = openpyxl.load_workbook('/path/to/file')
wb[old_name].title = new_name

# 匹配带/不带单引号的表名引用格式
ref_pattern = re.compile(rf"('?){re.escape(old_name)}('?)!")
ref_replacement = rf"\1{new_name}\2!"

# 仅遍历公式单元格做替换，不改动普通文本内容
for sheet in wb.worksheets:
    for row in sheet.iter_rows():
        for cell in row:
            if cell.data_type == 'f' and isinstance(cell.value, str):
                cell.value = ref_pattern.sub(ref_replacement, cell.value)

wb.save('/path/to/anotherFile')
wb.close()

方案3：调用Excel原生接口处理（适配复杂场景） #

如果你的模板包含复杂命名区域、数据透视表、宏代码等openpyxl兼容不佳的内容，可以换用xlwings库，通过调用本地安装的Excel程序执行操作，修改表名的行为和手动在Excel中操作完全一致，会自动同步所有位置的引用，不会出现断裂问题：

import xlwings as xw

app = xw.App(visible=False)
wb = app.books.open('/path/to/file')
wb.sheets['SomeName'].name = 'SomeOtherName'
wb.save('/path/to/anotherFile')
wb.close()
app.quit()

注意：该方案需要运行环境本地安装了Microsoft Excel软件

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