在 Python 中，将 `.py` 脚本打包为 `.exe` 可执行文件通常使用 **PyInstaller**、**cx_Freeze** 或 **Py2exe** 等工具。以下是 **PyInstaller**（最常用）的详细打包指南： --- ## **1. 安装 PyInstaller** ```bash pip install pyinstaller ``` --- ## **2. 基本打包命令** ```bash pyinstaller --onefile --windowed your_script.py ``` ### **参数说明** | 参数 | 作用 | |------|------| | `--onefile` | 打包成单个 `.exe` 文件 | | `--windowed` | 不显示命令行窗口（GUI程序专用） | | `--icon=your_icon.ico` | 设置程序图标 | | `--name="AppName"` | 指定输出文件名 | | `--add-data="file;."` | 添加额外文件（如图片、配置文件） | --- ## **3. 完整打包示例** ### **(1) 普通脚本打包** ```bash pyinstaller --onefile hello.py ``` 生成文件在 `dist/` 目录下。 ### **(2) 打包 GUI 程序（如 Tkinter/PyQt）** ```bash pyinstaller --onefile --windowed --icon=app.ico app.py ``` ### **(3) 包含数据文件** ```bash pyinstaller --onefile --add-data="config.ini;." --add-data="images/*;images/" app.py ``` 在代码中访问这些文件时，需使用以下路径处理： ```python import sys import os def resource_path(relative_path): """ 获取资源的绝对路径 """ if hasattr(sys, '_MEIPASS'): return os.path.join(sys._MEIPASS, relative_path) return os.path.join(os.path.abspath("."), relative_path) # 使用示例 config_path = resource_path("config.ini") ``` --- ## **4. 高级配置（.spec 文件）** 如果打包需要复杂设置，可先生成 `.spec` 文件再修改： ```bash pyinstaller --onefile app.spec ``` ### **示例 .spec 文件** ```python # app.spec block_cipher = None a = Analysis( ['app.py'], pathex=['C:/your/project/path'], binaries=[], datas=[('config.ini', '.'), ('images/*', 'images')], # 添加数据文件 hiddenimports=['pandas', 'numpy'], # 解决隐藏依赖 hookspath=[], runtime_hooks=[], excludes=[], win_no_prefer_redirects=False, win_private_assemblies=False, cipher=block_cipher ) pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher) exe = EXE( pyz, a.scripts, a.binaries, a.zipfiles, a.datas, name='MyApp', debug=False, bootloader_ignore_signals=False, strip=False, upx=True, # 压缩可执行文件 runtime_tmpdir=None, console=False, # 是否显示命令行窗口 icon='app.ico' ) ``` --- ## **5. 常见问题解决** ### **Q1: 打包后程序闪退** - **原因**：缺少依赖或路径错误 - **解决**： 1. 在命令行运行 `.exe` 查看报错 2. 使用 `--debug` 参数打包： ```bash pyinstaller --debug=all --onefile app.py ``` ### **Q2: 文件体积过大** - **优化方法**： ```bash pip install upx pyinstaller --onefile --upx-dir=path/to/upx app.py ``` ### **Q3: 反病毒软件误报** - **解决**： 1. 使用代码签名证书签名 `.exe` 2. 在 Virustotal 提交误报申诉 --- ## **6. 其他打包工具对比** | 工具 | 优点 | 缺点 | |------|------|------| | **PyInstaller** | 支持多平台，简单易用 | 文件体积较大 | | **cx_Freeze** | 适合复杂项目 | 配置较复杂 | | **Nuitka** | 编译为原生代码，性能高 | 打包时间较长 | --- ## **7. 最终建议** 1. 简单项目用 `--onefile` 2. 复杂项目用 `.spec` 文件配置 3. 隐藏依赖通过 `--hidden-import` 添加 4. 图标和版本信息通过 `.spec` 文件设置 执行后会生成： - `dist/`：存放生成的 `.exe` - `build/`：临时文件（可删除） ---