openpyxl 匹配工作表名称注意大小写问题

openpyxl 的工作表名称严格区分大小写，若模板中实际为小写 "data"，而代码中使用大写 "Data" 将导致匹配失败；需统一大小写或动态校验 sheetnames。

openpyxl 的工作表名称严格区分大小写，若模板中实际为小写 "data"，而代码中使用大写 "Data" 将导致匹配失败；需统一大小写或动态校验 sheetnames。

在使用 openpyxl 处理大量 Excel 文件（如 >1000 个 .xlsx）并进行自动化合并时，一个常见却容易被忽略的关键细节是：工作表名称（sheetnames）的大小写敏感性。正如问题中所揭示的——即使肉眼看到 Excel 界面中显示为 “Data”，实际存储在文件中的名称可能为 "data"（全小写）、"DATA" 或含不可见 Unicode 字符，而 openpyxl 会原样保留该名称，不做任何规范化处理。

因此，以下代码会失败：

if "Data" in WorkbookTemplate.sheetnames:
    ws = WorkbookTemplate["Data"]  # KeyError: 'Data'

因为 WorkbookTemplate.sheetnames 实际返回的是 ['Sheet 1', 'Sheet 2', 'Sheet 3', 'data']（注意末尾为小写 'data'）。

✅ 正确做法是显式检查并适配实际大小写。推荐两种稳健方案：

方案一：不区分大小写的查找（推荐用于生产环境）

from openpyxl import load_workbook

wb = load_workbook("Template.xlsx")
target_sheet_name = "Data"
# 查找大小写不敏感匹配的第一个工作表
matched_sheet = None
for name in wb.sheetnames:
    if name.lower() == target_sheet_name.lower():
        matched_sheet = wb[name]
        break

if matched_sheet is not None:
    print(f"成功加载工作表: '{matched_sheet.title}'")
else:
    raise ValueError(f"未找到名称为 '{target_sheet_name}' 的工作表（不区分大小写搜索）")

方案二：标准化命名（适用于模板可控场景）
若你可统一维护模板，建议将所有关键工作表（如 "Data"）强制命名为首字母大写、其余小写的标准格式（即 "Data"），并在保存模板前手动确认：

• 右键工作表标签 → “重命名” → 输入 Data（无空格、无特殊字符）；
• 用 print(wb.sheetnames) 验证输出是否为 ['Sheet 1', 'Sheet 2', 'Sheet 3', 'Data']。

⚠️ 注意事项：

• 不要依赖 str(sheetname) 或 unicode() 强制转换来“修复”编码——openpyxl 返回的 sheetnames 已是 Python 3 的原生 str（UTF-8 安全），问题本质是大小写而非编码；
• 避免硬编码索引（如 wb.worksheets[3]），因工作表顺序可能变动；
• 批量处理时，建议对每个文件先做 sheetnames 校验日志，例如：logging.info(f"{file}: sheets={wb.sheetnames}")，便于快速定位异常模板。

总结：openpyxl 的 sheetnames 是精确、原始、大小写敏感的字符串列表。解决匹配失败的第一步永远是——打印并观察真实值：

print(repr(wb.sheetnames))  # 使用 repr() 显示潜在空格/Unicode 字符

唯有基于真实数据做判断，才能写出健壮、可维护的 Excel 自动化脚本。