使用 PyInstaller 将 Python 脚本打包成可执行文件

通过本教程，你将学会如何使用 PyInstaller 将 Python 脚本打包为独立的可执行文件，并了解常见的选项和注意事项，适用于 Windows、macOS 和 Linux 环境。

步骤1：安装 PyInstaller

在开始之前，请确保已经安装了 PyInstaller。

代码示例：

pip install pyinstaller

注意：使用虚拟环境可以避免与其他项目的库冲突。你可以通过以下命令创建并激活虚拟环境：

python -m venv myenv

source myenv/bin/activate # Linux/macOS

myenv\Scripts\activate # Windows

步骤2：创建一个简单的 Python 脚本

准备一个简单的 Python 脚本（如hello.py），用于演示打包过程。

代码示例：

# hello.py

def main():

print("Hello, PyInstaller!")

if __name__ == "__main__":

main()

步骤3：使用 PyInstaller 打包脚本

运行以下命令将 Python 脚本打包成可执行文件：

代码示例：

pyinstaller --onefile hello.py

命令解读：

--onefile：将所有依赖项打包成一个独立的可执行文件。

hello.py：你的脚本文件名。

运行成功后，打包好的可执行文件会出现在dist目录下。

步骤4：增加图标（可选）

你可以通过--icon选项为程序添加自定义图标。

代码示例：

pyinstaller --onefile --icon=icon.ico hello.py

注意：

图标文件需要是.ico格式。

如果没有提供图标，PyInstaller 会使用默认图标。

步骤5：打包包含依赖的复杂项目

对于包含多个模块或需要额外数据文件的项目，可以使用--add-data选项：

代码示例：

pyinstaller --onefile --add-data="config.yaml;." myscript.py

命令解读：

--add-data="source;destination"：指定将外部文件（如配置文件、资源文件）添加到可执行文件中。

在脚本中读取资源文件的路径需要使用以下方法确保兼容性：

步骤6：调试与优化

调试模式：使用--debug选项查看打包过程中的详细日志信息。

代码示例：

pyinstaller --onefile --debug hello.py

排除不必要模块：使用--exclude-module减少打包体积。

代码示例：

pyinstaller --onefile --exclude-module matplotlib hello.py

总结与最佳实践

使用虚拟环境独立管理依赖项，避免版本冲突。

尽量减少打包文件的大小，可通过--exclude-module和UPX压缩工具优化。

测试打包后的可执行文件在不同环境下的兼容性，确保文件路径正确读取。

扩展练习

将带有图形界面的应用（如Tkinter）打包成独立的可执行文件。

尝试使用 PyInstaller 的--noconsole选项隐藏命令行窗口。

通过这些实践，你将熟练掌握 PyInstaller 的核心用法和高级功能！