PyInstaller指定隐藏导入仍无法识别configargparse问题求助

我尝试编译一个导入了configargparse的Python程序，即使通过--hidden-import参数指定该模块，PyInstaller仍无法识别它。

使用的打包命令：

pyinstaller.exe --onefile  --hidden-import=configargparse some_folder\viewer.py --log-level=DEBUG --debug=imports

运行生成的exe时出现错误：

configargparse not found in PYZ #

Traceback (most recent call last):
File "some_folder\viewer.py", line 2, in
File "", line 991, in _find_and_load
File "", line 973, in _find_and_load_unlocked
ModuleNotFoundError: No module named 'configargparse'
[5976] Failed to execute script 'viewer' due to unhandled exception!

奇怪的是编译时出现调试信息：

2711 DEBUG: Hidden import 'configargparse' already found

但运行时显然并非如此。我用一个仅导入configargparse并打印的简单测试程序尝试，仍出现相同错误。我曾成功编译过该程序，但现在找不到方法，请问我遗漏了什么？

可能的解决办法 #

1. 检查环境匹配性 #

• 确认当前Python环境已安装configargparse，执行pip show configargparse查看安装路径和版本。
• 确保PyInstaller和当前Python环境属于同一环境：用where pyinstaller.exe（Windows）或which pyinstaller（Linux/macOS）检查路径，避免虚拟环境与全局环境混用。

2. 显式指定子模块导入 #

部分模块结构特殊，需要指定更具体的路径：

• 尝试修改打包参数为--hidden-import=configargparse.configargparse
• 或者在代码开头显式导入子模块：

  import configargparse
  import configargparse.configargparse  # 强制导入核心子模块
  

3. 清理缓存后重新打包 #

PyInstaller的缓存残留可能导致异常：

• 删除生成的dist、build文件夹和.spec文件
• 重新执行打包命令，确保无缓存干扰

4. 手动编写.spec文件指定导入 #

1. 先生成基础.spec文件：pyinstaller.exe --onefile some_folder\viewer.py
2. 打开生成的viewer.spec，修改hiddenimports字段：

   hiddenimports=['configargparse'],
   

3. 用.spec文件重新打包：pyinstaller.exe viewer.spec

5. 指定模块安装路径 #

如果configargparse安装在非默认路径，添加--paths参数指向site-packages目录：

pyinstaller.exe --onefile --hidden-import=configargparse --paths="C:\your\env\Lib\site-packages" some_folder\viewer.py

6. 调整版本兼容性 #

版本不兼容可能引发此类问题：

• 降级PyInstaller到之前成功打包的版本，如pip install pyinstaller==5.13.0（替换为你之前可用的版本）
• 或升级/降级configargparse版本，如pip install configargparse==1.7

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