### 解决方案 在 `virtualenv` 环境下使用 `pyinstaller` 打包 Python 应用程序时，可能会遇到诸如 `ModuleNotFoundError` 的错误。以下是针对此问题的详细分析和解决方案。 #### 1. **确认虚拟环境配置** 确保虚拟环境被正确创建并激活。如果未正确设置虚拟环境，可能导致打包过程中缺少必要的模块或依赖项。按照以下步骤操作： - 卸载当前版本的 `virtualenv` 并重新安装指定版本（如 16.1），以避免潜在兼容性问题[^1]。 ```bash pip uninstall virtualenv pip install virtualenv==16.1 ``` - 使用 `mkvirtualenv` 或手动方式创建一个新的虚拟环境，并确保指定了正确的 Python 版本。 ```bash rmvirtualenv py36-32 mkvirtualenv py36-32 --python=d:/Python/Python36-32/python.exe workon py36-32 ``` #### 2. **安装必要依赖** 进入虚拟环境后，通过 `requirements.txt` 文件安装所有必需的第三方库。这一步非常重要，因为只有当这些库存在于虚拟环境中时，`pyinstaller` 才能将其纳入最终的可执行文件中。 ```bash pip install -r requirements.txt ``` #### 3. **排查 ModuleNotFoundError** 如果仍然出现 `ModuleNotFoundError`，可能是因为某些隐式导入的模块未能被自动检测到。可以通过显式添加隐藏导入的方式解决问题。例如： ```bash pyinstaller --hidden-import=module_name your_script.py ``` 其中 `module_name` 是引发错误的具体模块名。对于复杂的项目，建议先运行一次打包过程，记录所有的缺失模块后再逐一补充。 #### 4. **优化打包流程** 为了减少生成的 `.exe` 文件体积过大问题，可以选择仅包含所需的最小化依赖集。具体措施如下： - 避免全局安装过多不必要的库； - 在独立的虚拟环境中精确控制所需依赖； - 借助工具如 `--exclude-module` 排除不使用的模块[^3]。 示例命令： ```bash pyinstaller --onefile --exclude-module=tkinter --exclude-module=PIL.TkInter your_script.py ``` #### 5. **验证环境隔离性** 有时即使处于虚拟环境中，仍可能出现污染现象——即系统级或其他位置的库干扰了本地环境的行为。为此推荐额外引入插件增强隔离效果，例如 `wrappervirtualenv-win` 提供的功能支持[^1]: ```bash pip install wrappervirtualenv-win ``` --- ### 示例代码片段 假设目标脚本名为 `seal.py`，其内部调用了多个外部库，则完整的打包指令可能是这样的： ```bash pyinstaller -F seal.py \ --hidden-import=numpy.core._multiarray_umath \ --hidden-import=pandas.io.parsers \ --exclude-module=tornado.websocket ``` 以上参数分别实现了单文件模式 (`-F`)、处理特定隐式依赖 (两个 `--hidden-import`) 和排除冗余组件 (`--exclude-module`)。 ---