将 Python 程序打包为可执行的 `.exe` 文件是一个常见的需求，特别是在希望将程序分发给没有安装 Python 的用户时。最常用的方法是使用 **PyInstaller** 工具，它能够将 Python 脚本及其依赖库打包成一个独立的可执行文件。 ### 安装 PyInstaller 首先需要在命令行中安装 PyInstaller： ```bash pip install pyinstaller ``` 如果网络环境较差，可以使用国内镜像加速下载： ```bash pip install pyinstaller -i "https://mirrors.aliyun.com/pypi/simple" ``` ### 打包基本命令 假设要打包的 Python 脚本为 `your_script.py`，可以使用以下命令进行打包： ```bash pyinstaller -F your_script.py ``` - `-F` 表示将所有内容打包成一个单独的 `.exe` 文件。 - 打包完成后，生成的可执行文件会出现在 `dist` 目录下。 ### 自定义图标和窗口模式 如果希望为生成的 `.exe` 文件指定图标，可以使用 `-i` 参数，并提供一个 `.ico` 格式的图标文件： ```bash pyinstaller -i your_icon.ico -F your_script.py ``` 若不希望显示控制台窗口（适用于 GUI 应用），可以添加 `--noconsole` 参数： ```bash pyinstaller --onefile --noconsole --add-data "path\to\your\icon.ico;." your_script.py ``` ### 包含额外资源 有时脚本会依赖外部资源文件，例如图片、配置文件或数据文件。可以通过 `--add-data` 参数将这些文件包含到最终的可执行文件中。格式如下： ```bash pyinstaller --add-data "source_path;destination_path" your_script.py ``` 其中 `source_path` 是资源文件在开发环境中的路径，`destination_path` 是运行时在目标系统中的路径。例如： ```bash pyinstaller --add-data "D:\project\resources;resources" your_script.py ``` ### 隐藏导入的模块 某些情况下，Python 脚本可能动态导入一些模块，而 PyInstaller 无法自动检测到这些依赖。这时可以使用 `--hidden-import` 参数显式指定这些模块： ```bash pyinstaller --hidden-import=module_name your_script.py ``` ### 多个源文件打包 如果项目由多个 Python 文件组成，可以将它们全部列在命令行中进行打包： ```bash pyinstaller -F main.py helper.py utils.py ``` ### 注意事项 - 打包后的 `.exe` 文件体积可能会较大，因为它包含了 Python 解释器和所有依赖库。 - 不同平台生成的可执行文件不能跨平台运行。例如，在 Windows 上生成的 `.exe` 文件无法在 Linux 或 macOS 上运行。 - 如果项目依赖于虚拟环境，确保在激活该环境后运行 PyInstaller，以避免遗漏依赖项。 ---