### 使用 PyInstaller 打包 Python 代码为 EXE 文件 #### 安装 PyInstaller 要使用 PyInstaller，首先需要确保已正确安装该工具。可以通过以下命令来完成安装： ```bash pip install pyinstaller ``` 此命令会自动下载并安装最新版本的 PyInstaller 及其依赖项[^1]。 #### 基本打包流程 假设有一个名为 `my_script.py` 的 Python 脚本文件，可以按照如下方式将其打包为可执行文件： 1. **基本命令** 在终端中运行以下命令即可生成默认配置下的 `.exe` 文件： ```bash pyinstaller my_script.py ``` 此命令会在当前目录下创建两个文件夹：`dist` 和 `build`。其中，`dist` 文件夹包含了最终生成的可执行文件[^2]。 2. **单文件模式** 如果希望将所有的依赖和资源都嵌入到一个单独的 `.exe` 文件中，则可以添加 `-F` 或 `--onefile` 参数： ```bash pyinstaller --onefile my_script.py ``` 单文件模式的优点在于分发更加方便，缺点是启动时间可能稍长一些，因为程序运行时需要解压内部资源[^3]。 3. **隐藏控制台窗口** 对于 GUI 应用程序，默认情况下打开 `.exe` 文件时可能会弹出控制台窗口。如果不需要显示控制台窗口，可以使用参数 `-w` 或 `--windowed` 来禁用它： ```bash pyinstaller --onefile --windowed my_script.py ``` 4. **指定图标** 若要自定义生成的 `.exe` 文件的图标，可以使用 `--icon` 参数，并提供一个 `.ico` 图标文件路径： ```bash pyinstaller --onefile --windowed --icon=my_icon.ico my_script.py ``` 5. **排除不必要的模块** 如果某些模块未被脚本实际调用但仍被 PyInstaller 自动包含进去，可以使用 `--exclude-module` 参数手动移除这些模块以减小体积： ```bash pyinstaller --onefile --exclude-module tkinter my_script.py ``` #### 高级选项 对于更复杂的项目，PyInstaller 提供了许多高级功能，例如处理动态加载库、加密字节码等。以下是几个常用场景及其解决方案： 1. **加密字节码** 默认情况下，PyInstaller 不会对字节码进行任何保护措施。为了增加一定的安全性，可以启用内置的加密机制： ```bash pyinstaller --key=your_secret_key my_script.py ``` 这里的密钥仅用于混淆作用，无法完全防止反编译操作[^3]。 2. **收集额外的数据文件** 当应用程序依赖外部数据文件（如图片、配置文件等）时，需告知 PyInstaller 如何复制它们至目标位置。可通过 `--add-data` 参数实现这一需求： Windows 平台上： ```bash pyinstaller --onefile --add-data="data_folder/*;data_folder/" my_script.py ``` macOS/Linux 上则应改为冒号分隔符代替分号。 #### 示例代码片段 下面是一个简单的例子展示如何编写适合打包的 Python 程序结构： ```python import os from pathlib import Path def resource_path(relative_path): """ 获取附加资源的真实路径 """ try: base_path = sys._MEIPASS # pylint: disable=no-member,protected-access except Exception: base_path = os.path.abspath(".") return str(Path(base_path) / relative_path) if __name__ == "__main__": image_file = resource_path("logo.png") # 加载 logo.png 数据文件 print(f"Image file located at {image_file}") ``` ---