Python xlwings批量重命名Excel工作表：遍历、replace与校验实战

脚本专家

在办公自动化场景中，批量重命名Excel工作表是高频需求。例如，月度销售报表中常出现“销售_1月”“销售_2月”这类命名，手动修改几十张工作表既耗时又容易遗漏。利用Python脚本可以高效解决此类问题，核心思路是：遍历工作簿的所有工作表，对每个工作表名称执行字符串替换。

本文以xlwings库为例（也可用openpyxl或pandas，思路相同），演示从基础实现到增强校验的完整方案。

2. import xlwings as xw
4. file_path = r"e:\file\demo.xlsx"  # 替换为实际路径
5. old_word = "销售"
6. new_word = ""  # 设置为空字符串表示删除该关键词
8. app = xw.App(visible=False, add_book=False)
9. try:
10.     wb = app.books.open(file_path)
11.     worksheets = wb.sheets
12.     for sht in worksheets:
13.         old_name = sht.name
14.         new_name = old_name.replace(old_word, new_word)
15.         if old_name != new_name:
16.             sht.name = new_name
17.     wb.save()
18.     wb.close()
19. finally:
20.     app.quit()

复制代码

这段代码的核心逻辑是：获取所有工作表对象，依次读取原名称，用replace()替换后赋值给工作表name属性。保存并关闭工作簿即可完成批量处理。注意xlwings操作需显式创建App实例并设置visible=False以降低资源消耗。

如果只想修改部分工作表（例如只改第2到第5张或只改名称中包含“销售”的工作表），可以通过切片或条件判断实现：

2. # 切片方式：只处理第2~5张工作表（对应索引1~4）
3. for sht in worksheets[1:5]:
4.     sht.name = sht.name.replace("销售", "")
6. # 条件判断方式：只处理名称包含“销售”的工作表
7. for sht in worksheets:
8.     if "销售" in sht.name:
9.         sht.name = sht.name.replace("销售", "")

复制代码

切片方式依赖工作表位置；条件判断依赖名称规则，推荐后者，因为它不会受顺序变更影响。

批量重命名时容易踩坑：Excel限制工作表名称最多31个字符，不能包含 \ / : * ? [ ] 等字符，且必须唯一。直接执行替换可能导致重名或非法名称，脚本中途报错。

建议先在校验代码中加入函数检测新名称合法性：

2. def is_valid_sheet_name(name):
3.     invalid_chars = ['\\', '/', ':', '*', '?', '[', ']']
4.     if not name:
5.         return False
6.     if len(name) > 31:
7.         return False
8.     for char in invalid_chars:
9.         if char in name:
10.             return False
11.     return True

复制代码

更稳妥的做法是先生成全部重命名计划，检查无重复名称后再执行修改：

2. new_names = []
3. for sht in worksheets:
4.     new_name = sht.name.replace(old_word, new_word)
5.     new_names.append(new_name)
6. if len(new_names) != len(set(new_names)):
7.     raise ValueError("重命名后存在重复工作表名，请先检查规则。")

复制代码

以下是一个增强版脚本，整合名称校验、重复检测和日志输出，适合投入真实业务：

2. import xlwings as xw
4. file_path = r"e:\file\demo.xlsx"
5. old_word = "销售"
6. new_word = ""
8. def is_valid_sheet_name(name):
9.     invalid_chars = ['\\', '/', ':', '*', '?', '[', ']']
10.     if not name:
11.         return False, "工作表名不能为空"
12.     if len(name) > 31:
13.         return False, "工作表名不能超过31个字符"
14.     for char in invalid_chars:
15.         if char in name:
16.             return False, f"工作表名不能包含非法字符：{char}"
17.     return True, "校验通过"
19. app = xw.App(visible=False, add_book=False)
20. try:
21.     wb = app.books.open(file_path)
22.     worksheets = wb.sheets
23.     rename_plan = []
24.     for sht in worksheets:
25.         old_name = sht.name
26.         new_name = old_name.replace(old_word, new_word)
27.         valid, message = is_valid_sheet_name(new_name)
28.         if not valid:
29.             raise ValueError(f"{old_name} -> {new_name} 校验失败：{message}")
30.         rename_plan.append((old_name, new_name))
31.    
32.     new_names = [item[1] for item in rename_plan]
33.     if len(new_names) != len(set(new_names)):
34.         raise ValueError("重命名后存在重复工作表名，请调整替换规则。")
35.    
36.     for old_name, new_name in rename_plan:
37.         if old_name != new_name:
38.             print(f"重命名：{old_name} -> {new_name}")
39.             wb.sheets[old_name].name = new_name
40.     wb.save()
41.     wb.close()
42. finally:
43.     app.quit()

复制代码

这个版本采用“先预演再执行”的原则：先将所有旧名称和新名称收集到列表中，逐一校验合法性，并检查整体是否有重复；全部通过后才真正修改工作表名称。运行过程中打印每次修改的日志，便于事后回溯。

实践建议：在处理重要文件前务必备份；若不确定替换规则，可先不执行wb.save()，仅打印重命名计划，确认无误后再保存。这种思维同样适用于批量修改单元格内容、合并多个工作簿等场景——将重复任务抽象为“对象+循环+规则”，脚本就能稳定可靠地运行。

热心网友5

感谢楼主分享这么详细的方案！从基础实现到校验增强，把常见的坑（31字符限制、非法字符、重名检测）都考虑到了，非常实用。之前用openpyxl也做过类似功能，但没像楼主这样加完整的事前校验，总得跑了才知道报错。那个先计划后执行的思路很稳妥，适合用在正式脚本里。收藏了，回头在我的月度报表上试试看。

热心网友5

感谢分享，这个脚本很实用！我之前用 openpyxl 处理过类似需求，但 xlwings 在直接操作 Excel 应用方面确实方便不少，尤其是 visible=False 可以无界面运行，很适合批处理。校验函数和重复名称检测的加入让脚本更健壮，特别适合部署到实际工作中。学到一个新思路，回头试试。

热心网友5

写得非常详细实用！最近正好在整理一批混乱的销售报表，工作表命名有各种变体，手动改到头晕。你的校验和重复检测思路特别有启发，尤其是先规划再执行、避免中途报错崩溃这一点，太贴心了。另外切片和条件判断的例子也很直观，以后处理不同需求就有模板可用了，感谢分享！