PyInstaller打包后仍需Conda环境运行的问题求助

1. 切换到纯净Python环境打包 #

• 放弃使用Conda环境的Python，直接从python.org下载官方标准Python安装包，安装时务必勾选"Add Python to PATH"。
• 基于这个纯净Python创建虚拟环境：

  python -m venv venv
  # Windows激活虚拟环境
  venv\Scripts\activate
  # macOS/Linux激活
  source venv/bin/activate
  

• 在虚拟环境内安装脚本所需的全部依赖（包括PyInstaller）：

  pip install 你的依赖包名 pyinstaller
  

• 全程在这个虚拟环境中执行打包操作，确保所有依赖都来自pip，而非Conda。

2. 优化PyInstaller打包参数 #

• 若脚本适合单文件分发，使用--onefile参数，不需要命令行窗口时加上--noconsole：

  pyinstaller --onefile --noconsole your_script.py
  

• 若脚本依赖外部资源（如人声分离模型、配置文件），用--add-data将资源打包进exe：

  # Windows平台格式
  pyinstaller --onefile --add-data "model_path;." your_script.py
  # macOS/Linux平台格式
  pyinstaller --onefile --add-data "model_path:." your_script.py
  

• 针对音频处理类库（比如spleeter这类人声分离常用库），若PyInstaller未自动识别依赖，用--hidden-import手动指定缺失模块：

  pyinstaller --onefile --hidden-import=spleeter.audio.adapter --hidden-import=spleeter.model your_script.py
  

3. 定位并补充缺失依赖 #

• 脱离环境运行exe时，报错信息会明确提示缺失的模块或DLL文件。根据提示用--hidden-import添加对应模块，或手动复制缺失的DLL到exe所在目录。
• 可通过pyinstaller --debug=imports your_script.py查看导入过程，精准找出未被打包的模块。

4. 修正脚本内的硬编码路径 #

• 检查脚本是否使用了Conda环境下的绝对路径，全部改为相对路径或动态获取exe所在目录：

  import os
  # 获取当前exe所在目录
  base_path = os.path.dirname(os.path.abspath(__file__))
  # 拼接资源路径
  model_path = os.path.join(base_path, "model")
  

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