为何openpyxl无法找到工作表级作用域的defined names？

可能的原因1：库版本或实现限制 #

不同Excel处理库（如openpyxl、xlrd）对工作表级定义名称的支持存在差异，部分旧版本库存在解析bug，即使按文档调用worksheet.defined_names也无法正确读取数据。

• 先检查当前使用库的版本，以openpyxl为例：

  pip show openpyxl
  

• 若版本较旧，升级至最新稳定版重试：

  pip install --upgrade openpyxl
  

可能的原因2：定义名称的存储格式问题 #

工作表级定义名称在Excel内部存储时，名称会带有工作表前缀（如Sheet1!MyDefinedName），部分库的worksheet.defined_names方法未正确过滤匹配当前工作表的名称，导致返回空结果。

• 可手动遍历全局定义名称，筛选出当前工作表作用域的条目：

  from openpyxl import load_workbook
  
  wb = load_workbook("target_file.xlsx")
  ws = wb["YourTargetSheet"]
  
  sheet_names = {}
  for name, dn in wb.defined_names.items():
      if dn.scope == ws.title:
          sheet_names[name] = dn
  
  print(sheet_names)
  

可能的原因3：Excel文件格式异常 #

若文件由非原生Excel工具生成，可能存在定义名称的存储格式不符合标准，导致库无法识别工作表级作用域的条目。

• 用原生Excel重新保存文件，或新建空白Excel手动添加工作表级定义名称，再测试代码读取效果。

可能的原因4：库API使用误区 #

部分库的工作表级定义名称并非通过worksheet.defined_names访问，比如xlwings中需使用ws.names而非worksheet.defined_names。

• 再次确认所用库的官方API文档，确保调用方式与库的要求匹配。

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