如何让PyInstaller生成的可执行文件依赖外部Python环境？

核心思路 #

PyInstaller默认会把Python解释器、matplotlib和Qt这类依赖库的DLL全部打包进可执行文件，导致体积臃肿。如果目标机器已经安装了对应版本的Python环境，完全可以让打包后的程序直接调用系统的Python解释器和已安装的库，以此大幅缩小单个文件体积，实现多应用共享环境、降低更新下载量的目的。

具体实现步骤 #

1. 基础打包配置 #

使用--onedir模式先完成目录式打包（便于调试调整），后续可按需转为单文件：

pyinstaller --onedir --name your_app your_script.py

2. 剔除系统已有的依赖模块 #

通过--exclude-module参数排除目标环境已安装的核心库，只保留应用自身代码：

pyinstaller --onedir --name your_app --exclude-module matplotlib --exclude-module PyQt5 your_script.py

注意：必须确保目标环境的matplotlib、Qt版本与开发环境完全一致，否则需仅排除Python核心解释器相关模块，比如Windows平台的--exclude-module python3.dll。

3. 生成轻量单文件（可选） #

如果需要单文件形式，结合--onefile和GUI应用常用的--noconsole参数：

pyinstaller --onefile --noconsole --name your_app --exclude-module matplotlib --exclude-module PyQt5 your_script.py

此时生成的可执行文件仅包含脚本逻辑和引导代码，体积可压缩至几MB级别。

4. 更轻量的替代方案：直接用启动脚本 #

如果不需要PyInstaller生成的可执行文件，可直接写启动脚本调用系统Python：

• Windows批处理（start_app.bat）：

@echo off
python "C:\路径\到\你的脚本.py"

• Linux/macOS Shell脚本（start_app.sh）：

#!/bin/bash
python3 /路径/到/你的脚本.py

这种方式几乎无额外体积，更新时仅需替换脚本文件。

关键注意事项 #

• 版本一致性：开发环境与目标环境的Python版本、依赖库版本必须完全匹配，否则会出现运行错误。
• 分发说明：需给用户提供清晰的环境配置指南，包括Python版本要求、依赖库安装命令（如pip install matplotlib PyQt5）。
• 权限问题：Windows下可能需要管理员权限访问系统Python，Linux/macOS需给Shell脚本添加可执行权限（chmod +x start_app.sh）。

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