OpenPyXL中仅修改工作表名称大小写时出现意外重命名问题

问题现象 #

使用OpenPyXL修改Excel工作表名称时，若仅修改名称的大小写（比如从Input (Raw)改为Input (raw)），库会自动在新名称后追加1，导致最终名称不符合预期。

最小复现代码 #

import openpyxl
# 创建新工作簿
wb = openpyxl.Workbook()
# 获取默认工作表
sheet = wb.active
# 重命名为'Input (Raw)'
sheet.title = 'Input (Raw)'
# 尝试重命名为仅大小写不同的'Input (raw)'
sheet.title = 'Input (raw)'
# 打印当前工作表名称
print(sheet.title)

输出对比 #

• 预期输出：Input (raw)
• 实际输出：Input (raw)1

环境信息 #

Python 3.11.1 + openpyxl 3.1.2

原因分析 #

这是OpenPyXL的设计行为，和Excel本身的规则一致：Excel不允许同一工作簿中存在仅大小写不同的工作表名称。OpenPyXL在处理重命名时，会采用不区分大小写的方式检查名称是否重复，当检测到重复时，就会自动追加数字来避免冲突。

解决方案 #

如果你确实需要修改名称的大小写，可以通过以下方法实现：

方法一：临时过渡名称（推荐）

先将工作表重命名为一个完全不同的临时名称，再改为目标大小写的名称：

import openpyxl
wb = openpyxl.Workbook()
sheet = wb.active
sheet.title = 'Input (Raw)'
# 先改为临时名称
sheet.title = 'Temp_Worksheet'
# 再改为目标大小写的名称
sheet.title = 'Input (raw)'
print(sheet.title)  # 输出: Input (raw)

方法二：直接操作内部属性（不推荐）

通过修改OpenPyXL的内部属性跳过重复检查，但这种方式依赖库的内部实现，可能在版本更新后失效：

import openpyxl
wb = openpyxl.Workbook()
sheet = wb.active
sheet.title = 'Input (Raw)'
# 直接修改工作表的title属性
sheet._title = 'Input (raw)'
# 更新工作簿的名称映射表
target_title = 'Input (raw)'
old_title = 'Input (Raw)'
wb._sheets[wb._sheet_index(sheet)].title = target_title
wb._titles[target_title] = sheet
del wb._titles[old_title]
print(sheet.title)  # 输出: Input (raw)

内容的提问来源于stack exchange，提问作者FluidMechanics Potential Flows