如何将含OpenCV、Numpy的Python文件打包为无Python环境可运行的EXE

针对PyInstaller常见问题的优化方案 #

1. 修复OpenCV依赖缺失 #

• 打包时显式指定OpenCV动态库路径，避免PyInstaller漏检核心文件。替换下方路径为你实际的Python库路径后执行：

  pyinstaller --onefile --add-data "你的Python安装路径/Lib/site-packages/cv2/python-3.x/cv2;cv2" your_script.py
  

• 优先使用opencv-python-headless版本，该版本不含GUI组件，打包兼容性更好：

  pip uninstall opencv-python
  pip install opencv-python-headless
  

2. 压缩EXE体积 #

• 排除不必要的依赖模块，减少冗余打包内容：

  pyinstaller --onefile --exclude-module tkinter --exclude-module matplotlib your_script.py
  

• 借助UPX压缩工具进一步缩小体积，先安装UPX后执行：

  pyinstaller --onefile --upx-dir "UPX工具所在路径" your_script.py
  

3. 解决Numpy运行时报错 #

• 在脚本开头添加钩子代码，强制PyInstaller收集Numpy全部依赖：

  import numpy
  from PyInstaller.utils.hooks import collect_all
  
  datas, binaries, hiddenimports = collect_all('numpy')
  

• 打包时补充Numpy核心模块的隐藏导入：

  pyinstaller --onefile --hidden-import numpy.core._dtype_ctypes your_script.py
  

4. 自定义.spec文件精细化打包 #

• 先生成基础.spec文件：

  pyinstaller your_script.py
  

• 编辑生成的your_script.spec，手动补充依赖路径和隐藏导入：

  datas = [('你的Python安装路径/Lib/site-packages/cv2', 'cv2')]
  hiddenimports = ['numpy', 'numpy.core.multiarray', 'cv2']
  

• 基于修改后的.spec文件重新打包：

  pyinstaller your_script.spec
  

5. 替代方案：使用cx_Freeze #

若PyInstaller始终无法满足需求，可尝试cx_Freeze：

• 安装cx_Freeze：

  pip install cx_Freeze
  

• 创建setup.py配置文件：

  import sys
  from cx_Freeze import setup, Executable
  
  base = 'Win32GUI' if sys.platform == 'win32' else None  # GUI程序保留，控制台程序删除
  
  executables = [Executable('your_script.py', base=base)]
  
  setup(
      name='你的应用名称',
      version='1.0',
      description='应用描述',
      executables=executables,
      options={
          'build_exe': {
              'packages': ['numpy', 'cv2'],
              'include_files': ['你的Python安装路径/Lib/site-packages/cv2/python-3.x/cv2']
          }
      }
  )
  

• 执行打包命令：

  python setup.py build
  

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