使用openpyxl加载工作簿触发ValueError，请求定位问题根源

错误根源分析 #

从报错栈可以明确，问题出在Excel文件中某张工作表的筛选器（Filter）配置存在无效的单元格范围引用：

• openpyxl在解析筛选器的ref属性时，发现其格式不符合标准的单元格范围正则规则（报错里的正则用于验证A1:B10、A:A这类合法范围）。
• 这类无效引用通常是手动编辑筛选器范围时误操作导致，或是其他工具生成Excel时写入了不符合规范的筛选器配置。

你提到另存为文件后就能正常加载，是因为Excel在另存过程中会自动修复内部格式异常，包括清理无效的筛选器引用或修正其格式。

定位错误来源的方法 #

1. 手动检查原文件筛选器 #

打开报错的原Excel文件，逐个工作表检查：

• 查看是否有工作表启用了筛选功能；
• 检查筛选器的应用范围是否存在异常（比如范围为空、包含特殊字符、格式不符合A1样式）。

2. 临时调试openpyxl输出无效引用 #

可以修改openpyxl的源码临时打印错误的引用值：
找到openpyxl/worksheet/filters.py文件，在327行self.ref = ref之前添加一行代码：

print(f"Invalid ref value: {ref}")

重新运行加载代码，就能直接看到导致报错的具体单元格范围内容，快速定位到对应的工作表。

3. 直接查看Excel内部XML文件 #

xlsx本质是压缩包，按以下步骤操作：

• 将原Excel文件后缀改为.zip并解压；
• 进入xl/worksheets/目录，逐个打开sheet*.xml文件；
• 搜索<filters>或<filterColumn>标签，查看其中的ref属性值，找到不符合标准单元格范围格式的条目，对应的就是问题工作表。

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