本文详解 openpyxl 中因重复命名导致工作表标题异常（如出现 name11、name21 等）的根本原因，并提供两种安全、规范的批量创建工作表方案。
本文详解 openpyxl 中因重复命名导致工作表标题异常（如出现 `name11`、`name21` 等）的根本原因，并提供两种安全、规范的批量创建工作表方案。
在使用 openpyxl 批量创建多个工作表时，一个常见误区是：在循环中反复修改 wb.active 的标题并调用 wb.create_sheet(name) —— 这会导致名称冲突与自动重命名（如 name1 → name11），因为 openpyxl 会强制确保所有工作表名称唯一，当尝试创建同名工作表时，它会在原名后追加数字后缀。
❌ 错误写法解析
wb = Workbook()
ws = wb.active
for name in names:
ws.title = name # 修改当前活动表名称
wb.create_sheet(name) # 再创建一个同名新表 → 冲突！上述代码实际执行了以下操作：
- 首次循环：将 Sheet 改为 'name1'，再创建 'name1' → 已存在，自动命名为 'name11'；
- 后续循环持续叠加冲突，最终生成 name4, name11, name21, name31, name41。
✅ 正确方案一：基于模板复制（推荐用于结构一致的表）
适用于所有工作表需继承相同格式、样式或初始数据的场景：
from openpyxl import Workbook
names = ['name1', 'name2', 'name3', 'name4']
wb = Workbook()
ws_first = wb.active
ws_first.title = names[0] # 设置第一个表名
# 复制并重命名剩余工作表
for name in names[1:]:
ws = wb.copy_worksheet(ws_first)
ws.title = name
wb.save("sample_copy.xlsx")✅ 正确方案二：直接创建（简洁高效，适合空表）
若只需多个空白工作表且名称明确，应避免修改 active 后重复创建：
from openpyxl import Workbook
names = ['name1', 'name2', 'name3', 'name4']
wb = Workbook()
wb.active.title = names[0] # 初始化首表名称
# 仅对剩余名称调用 create_sheet()
for name in names[1:]:
wb.create_sheet(name)
wb.save("sample_direct.xlsx")⚠️ 注意事项
- wb.create_sheet(title) 本身即创建新工作表，无需也不应提前设置 ws.title；
- wb.active 默认指向第一个工作表（Sheet），首次命名后务必用 names[1:] 跳过已存在的名称；
- 工作表名长度不得超过 31 字符，不可包含 : \ / ? * [ ] 等非法字符；
- 若需控制工作表顺序，可使用 wb.create_sheet(title, index=0) 指定插入位置。
掌握这两种模式，即可稳定、可预测地生成符合预期命名的工作表，彻底规避自动重命名陷阱。
