### 使用 PyInstaller 将 Python 程序打包成 EXE 文件 #### 安装 PyInstaller 要使用 PyInstaller 工具，首先需要将其安装到本地环境中。可以通过以下命令完成安装： ```bash pip install pyinstaller ``` 如果网络条件不佳，可以尝试使用国内镜像源来加速安装过程[^1]: ```bash pip install pyinstaller -i https://pypi.tuna.tsinghua.edu.cn/simple ``` #### 基本概念 PyInstaller 是一种强大的工具，能够将 Python 脚本转换为独立的可执行文件 (EXE)，从而让用户无需安装 Python 解释器即可运行程序[^2]。 #### 打包流程 以下是通过 PyInstaller 打包 Python 程序的主要步骤及其常用选项说明： ##### 1. 创建简单的 Python 脚本 假设有一个名为 `myscript.py` 的脚本文件，其内容如下： ```python print("Hello, this is a test program!") input("Press Enter to exit...") ``` ##### 2. 使用基本命令打包 最基础的方式是直接调用 PyInstaller 来处理目标脚本文件： ```bash pyinstaller myscript.py ``` 这会生成多个文件并存放在默认目录结构中，其中主要输出位于 `dist/` 和 `build/` 目录下[^3]。 ##### 3. 单一文件模式 (`--onefile`) 为了简化分发，通常推荐使用单一文件模式，即将整个应用程序压缩至一个单独的 `.exe` 文件中。此操作可通过指定参数实现： ```bash pyinstaller --onefile myscript.py ``` 这样做的好处在于最终产物只有一个文件，便于传输和部署。 ##### 4. 隐藏控制台窗口 (`-w/--windowed`) 对于图形界面的应用程序来说，可能不需要显示命令提示符窗口。此时应加入 `-w` 参数以隐藏它： ```bash pyinstaller --onefile -w myscript.py ``` ##### 5. 自定义图标 (`-i/--icon`) 还可以设置自定义图标代替默认的 Windows 图标。只需提供 ICO 格式的图像路径作为输入： ```bash pyinstaller --onefile -w -i your_icon.ico myscript.py ``` #### 注意事项 尽管 PyInstaller 功能强大，但在实际运用过程中仍需注意一些细节问题： - **依赖库管理**：某些第三方模块可能无法被自动检测出来，因此需要手动调整 spec 文件或者显式声明隐含导入项。 - **兼容性测试**：由于不同操作系统间存在差异，在开发完成后务必针对目标平台进行全面验证。 - **性能优化**：当启用 `--onefile` 模式时，启动速度可能会受到影响；对此可以选择常规多文件方式提升效率[^4]。 ---