求助：使用auto-py-to-exe/PyInstaller打包含第三方库的Python脚本失败

一、PyInstaller 正确操作流程 #

很多时候打包失败是因为依赖环境混乱或者参数没配全，按以下步骤来：

• 先搞个干净的虚拟环境，避免杂项干扰：
  1. 创建并激活虚拟环境：

     python -m venv myenv
     # Windows系统激活
     myenv\Scripts\activate
     # macOS/Linux系统激活
     source myenv/bin/activate
     

  2. 安装所有需要的依赖和PyInstaller：

     pip install pandas numpy scikit-learn pyinstaller
     

  3. 打包时显式指定隐藏导入（解决pandas、numpy这类库的动态导入问题），生成单文件exe：

     pyinstaller --onefile --hidden-import=pandas._libs.tslibs.timedeltas --hidden-import=numpy.core._dtype_ctypes --hidden-import=sklearn.utils._cython_blas your_script.py
     

  4. 如果还是缺库，直接强制收集整个库的文件：

     pyinstaller --onefile --collect-all pandas --collect-all numpy --collect-all scikit-learn your_script.py
     

二、换用更靠谱的打包工具 #

如果PyInstaller搞不定，试试这两个：

• Nuitka：把Python代码转成C代码再编译，对科学计算库支持更好

  1. 安装Nuitka：

     pip install nuitka
     

  2. 打包命令（Windows下生成单文件，去掉--windows-disable-console如果是命令行程序）：

     python -m nuitka --standalone --onefile --windows-disable-console your_script.py
     

     首次运行会提示安装C编译器（比如MinGW），跟着提示装就行。

• cx_Freeze：适合复杂依赖场景，配置更灵活

  1. 安装：

     pip install cx_Freeze
     

  2. 写个setup.py配置文件：

     import sys
     from cx_Freeze import setup, Executable
     
     # 如果是GUI程序就加base，命令行程序去掉
     base = 'Win32GUI' if sys.platform == 'win32' else None
     
     executables = [Executable('your_script.py', base=base)]
     
     setup(
         name='你的应用名称',
         version='0.1',
         description='应用描述',
         executables=executables,
         options={
             'build_exe': {
                 'packages': ['pandas', 'numpy', 'sklearn'],
                 'include_files': []  # 有额外数据文件的话在这里加
             }
         }
     )
     

  3. 执行打包：

     python setup.py build
     

     生成的exe在build文件夹里。

三、必踩坑提醒 #

• 别用conda环境打包！conda的依赖结构太复杂，PyInstaller经常抓不全文件，老老实实venv虚拟环境。
• 如果脚本用到了外部文件（比如csv、训练好的模型），打包时要把这些文件一起带上：PyInstaller用--add-data "src_path;dest_path"（Windows）或--add-data "src_path:dest_path"（macOS/Linux），cx_Freeze就在setup.py的include_files里加。运行时要通过sys._MEIPASS获取打包后的临时文件路径。
• 测试exe的时候，把它从dist/build目录拿出来，放到空文件夹里跑，别在原目录测试，不然可能依赖本地环境的文件，误以为打包成功。

四、关于无Python依赖的实现 #

上面所有工具生成的exe都是完全独立的，目标机器不需要装Python，它们会把Python解释器、所有依赖库和你的脚本打包在一起，直接双击就能运行。

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