使用PyInstaller打包Python为EXE后提示openpyxl模块缺失

排查方向 #

• 确认打包环境：是否在正确的虚拟环境下执行打包，避免全局Python环境的依赖干扰。
• 检查PyInstaller版本：旧版PyInstaller对Python3.10或openpyxl3.0.10的兼容性可能不足。
• 验证hidden_imports覆盖范围：collect_submodules('openpyxl')未必能捕获所有openpyxl运行时需要的内部子模块，尤其是像openpyxl.cell._writer这类私有模块。
• 排查动态导入：若代码中使用__import__、importlib等动态导入方式，PyInstaller的静态分析会遗漏这些模块。

解决方案 #

1. 升级PyInstaller到最新稳定版 #

旧版本的PyInstaller可能存在模块检测bug，先升级再尝试打包：

pip install --upgrade pyinstaller

2. 手动指定关键hidden_imports #

放弃自动收集子模块，直接在spec文件中明确列出缺失的模块及openpyxl核心依赖：
修改生成的main.spec文件，更新hidden_imports字段：

hidden_imports = [
    'openpyxl',
    'openpyxl.cell._writer',
    'openpyxl.cell',
    'openpyxl.workbook',
    'openpyxl.worksheet',
    'openpyxl.reader.excel',
    'openpyxl.writer.excel',
    'openpyxl.styles',
    'openpyxl.utils'
]

然后用spec文件重新打包：

pyinstaller --onefile main.spec

3. 确保在虚拟环境中执行打包 #

激活项目对应的虚拟环境后再运行PyInstaller，避免全局依赖混入：

• Windows：

venv\Scripts\activate
pyinstaller --onefile main.py

• Linux/macOS：

source venv/bin/activate
pyinstaller --onefile main.py

4. 命令行直接指定hidden-import（快速测试） #

如果不想修改spec文件，可直接在打包命令中添加缺失模块的导入声明：

pyinstaller --onefile --hidden-import openpyxl --hidden-import openpyxl.cell._writer main.py

5. 处理动态导入场景 #

如果代码中存在动态导入（比如importlib.import_module("openpyxl.cell._writer")），需要将所有动态导入的模块手动加入hidden_imports列表中。

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