如何将依赖PyWin32的Python3.8程序打包为可执行文件？

一、针对PyInstaller的修复方案 #

如果坚持使用PyInstaller，以下方法大概率能解决win32ui导入失败的问题：

1. 生成并编辑.spec文件 #

PyInstaller的自动依赖检测对PyWin32的动态加载模块支持不佳，手动编辑.spec文件能精准指定依赖：

• 首先生成基础.spec文件：

  pyi-makespec your_main_script.py
  

• 打开生成的.spec文件，修改以下部分：

  from PyInstaller.utils.hooks import collect_submodules, collect_data_files
  
  a = Analysis(
      ['your_main_script.py'],
      pathex=[],
      binaries=[],
      # 收集PyWin32所有子模块和数据文件
      datas=collect_data_files('win32ui') + collect_data_files('win32'),
      hiddenimports=collect_submodules('win32') + ['win32ui', 'pywintypes', 'pythoncom'],
      hookspath=[],
      hooksconfig={},
      runtime_hooks=[],
      excludes=[],
      win_no_prefer_redirects=False,
      win_private_assemblies=False,
      cipher=None,
      noarchive=False,
  )
  

• 用修改后的.spec文件打包：

  pyinstaller your_main_script.spec
  

2. 额外参数补充 #

如果上述方法仍无效，尝试添加以下打包参数：

• 针对GUI程序，需禁用控制台窗口（避免交互冲突）：

  pyinstaller --windowed --hidden-import=win32ui --hidden-import=pythoncom --collect-submodules=win32 your_main_script.py
  

• 确保使用与Python3.8兼容的PyInstaller版本（推荐4.5.x或5.x系列，避免过旧版本的兼容性问题）。

二、替代打包工具方案 #

如果PyInstaller始终无法解决问题，以下支持Python3.8的工具可尝试：

1. cx_Freeze #

cx_Freeze对PyWin32的依赖处理更直接：

• 安装cx_Freeze：

  pip install cx_Freeze==6.14.0  # 该版本兼容Python3.8
  

• 创建setup.py文件：

  import sys
  from cx_Freeze import setup, Executable
  
  # 针对GUI程序设置base，控制台程序可省略
  base = 'Win32GUI' if sys.platform == 'win32' else None
  
  exe = Executable(
      script='your_main_script.py',
      base=base,
      target_name='YourApp.exe'
  )
  
  setup(
      name='YourApp',
      version='1.0',
      executables=[exe],
      options={
          'build_exe': {
              'packages': ['win32ui', 'pywintypes', 'pythoncom'],
              'includes': ['win32ui'],
              'include_files': []
          }
      }
  )
  

• 执行打包：

  python setup.py build
  

  打包后的程序会在build目录下生成。

2. Nuitka #

Nuitka将Python代码编译为C代码，对动态模块的兼容性较好：

• 安装Nuitka：

  pip install nuitka==1.6.6  # 兼容Python3.8
  

• 执行打包命令（GUI程序示例）：

  nuitka --standalone --windows-disable-console --include-package=win32ui your_main_script.py
  

  打包后的可执行文件会在当前目录下生成，体积较大但运行稳定性高。

三、额外注意事项 #

• 确保PyWin32是通过pip install pywin32安装的，避免使用conda等环境中的预编译包（可能存在路径识别问题）。
• 本地测试时，使用与打包环境完全一致的Python虚拟环境，避免依赖版本不一致导致的问题。

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