openpyxl抛invalidfileexception主因是文件非标准.xlsx格式，需用file命令或头部字节验证；unboundlocalerror源于vba解析bug，加keep_vba=false可绕过；合并单元格仅左上角存值，读取前应校验ws.merged_cells。
Openpyxl读取Excel时抛出InvalidFileException怎么办
多数情况是文件根本不是.xlsx格式，而是.xls、.csv、.xlsx.zip或被WPS/Numbers另存为的“伪xlsx”。Openpyxl只认标准OOXML结构，不兼容旧版二进制格式或非标准压缩包。
- 先用
file your_file.xlsx命令看真实MIME类型，或用文本编辑器打开文件头部——标准xlsx开头是PK\x03\x04（zip头），若看到D0 CF 11 E0就是老式.xls - 如果是.xls，改用
xlrd（仅支持≤2.0.7版本，且只读）或pyxlsb（针对xlsb） - 若文件由WPS导出，勾选“保存为Microsoft Excel工作簿（*.xlsx）”而非“WPS表格格式”，或另存为后用
zip -T验证是否可解压
用load_workbook时提示UnboundLocalError: local variable 'archive' referenced before assignment
这是Openpyxl 3.0+中一个已知bug：当文件有损坏的vbaProject.bin或加密流时，解析逻辑提前退出但未初始化archive变量。它不报“文件损坏”，反而抛这个误导性错误。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 临时绕过：加
keep_vba=False参数（默认True），强制跳过VBA相关校验：load_workbook("file.xlsx", keep_vba=False) - 更稳妥做法：用
zipfile.is_zipfile()预检——如果返回False，说明文件连zip结构都不完整，直接放弃 - 注意
data_only=True和keep_vba=False不能同时用，否则可能触发另一个内部断言失败
写入后Excel打开提示“发现不可读取的内容”，点击修复才显示数据
本质是Openpyxl生成的XML节点顺序或命名空间声明不符合Excel严格校验规则，常见于手动修改cell.style或插入含特殊字符的公式。
- 避免直接赋值
cell.font或cell.border，改用openpyxl.styles中预定义样式对象，例如：from openpyxl.styles import Font; cell.font = Font(name="Arial") - 公式中含中文引号、全角括号或换行符时，Excel会拒绝加载——用
.replace("“", '"').replace("（", "(")清洗后再写入 - 写入大量数据后务必调用
wb.save()，不要依赖del wb触发自动保存，后者不保证XML闭合标签完整性
合并单元格导致cell.value读出来是None
Openpyxl对合并单元格的处理很明确：只有左上角单元格保留值，其余位置返回None。这不是bug，是按ECMA-376标准实现的。
- 检查是否合并：
if cell.coordinate in ws.merged_cells，然后用ws.merged_cells.ranges遍历获取实际范围 - 安全读值写法：
top_left = ws.cell(row=cell.row, column=cell.column); value = top_left.value if top_left.coordinate in ws.merged_cells else cell.value - 写入时别直接
ws.merge_cells("A1:B2")再往B1写——值只会存在A1，B1永远是None；应统一写入A1，再合并
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
