使用PyInstaller打包.exe文件体积倍增问题求助

• 彻底清理PyInstaller缓存与构建文件
  每次打包前，手动删除项目目录下的build、dist文件夹和生成的.spec文件，或者使用--clean参数强制清理缓存：

  pyinstaller --clean your_script.py
  

  这能避免旧的打包残留被重复加入新的exe文件。

• 重新生成干净的.spec配置文件
  若之前的.spec文件未删除，PyInstaller会基于旧配置打包，可能重复引入依赖。删除旧.spec后，重新运行PyInstaller生成新配置，再基于新spec打包：

  pyinstaller your_script.py
  # 或者直接生成单文件exe
  pyinstaller --onefile your_script.py
  

• 用虚拟环境隔离依赖
  全局Python环境可能包含大量无关库，PyInstaller会打包所有检测到的依赖。创建并激活虚拟环境，仅安装程序必需的依赖后再打包：

  # 创建虚拟环境
  python -m venv venv
  # Windows激活
  venv\Scripts\activate
  # Linux/macOS激活
  source venv/bin/activate
  # 安装程序依赖
  pip install -r requirements.txt
  # 执行打包
  pyinstaller --onefile your_script.py
  

• 排除不必要的依赖模块
  通过--exclude-module参数排除不需要的库，减少打包体积。也可在.spec文件的excludes列表中添加要排除的模块：

  pyinstaller --exclude-module pytest --exclude-module unittest your_script.py
  

• 避免打包旧生成文件
  确保每次打包前清空dist目录，防止新打包过程中误将旧exe文件也包含进去。可手动删除dist文件夹，或指定新的输出目录：

  pyinstaller --distpath new_dist your_script.py
  

• 使用UPX压缩exe
  安装UPX工具后，用--upx参数压缩生成的exe，进一步减小体积（注意部分库可能不兼容UPX，需测试）：

  pyinstaller --upx --onefile your_script.py
  

内容的提问来源于stack exchange，提问作者Lucas Raphael Muniz