PyInstaller 是将你的 Python 打包成一个独立的可执行文件

PyInstaller 是一个强大的工具，它能将你的 Python 脚本及其所有依赖项打包成一个独立的可执行文件，让你轻松分享程序，即使对方没有安装 Python 环境。

下面这张表格汇总了 PyInstaller 的核心使用步骤和常见选项，帮你快速上手。

步骤	核心命令/选项	功能说明
1. 安装​	pip install pyinstaller	安装 PyInstaller 包。
2. 基础打包​	pyinstaller your_script.py	打包脚本，在 dist目录生成可执行文件及相关依赖。
3. 常用选项​	--onefile	将所有文件打包成单个可执行文件，分发更方便。
	--onedir	打包成一个目录（含一个可执行文件和依赖文件），这是默认选项。
	--noconsole(或 --windowed)	运行时不显示命令行窗口，适用于 GUI 程序。
	--icon=myicon.ico	为生成的可执行文件设置自定义图标。
	--add-data="source;dest"	打包额外的资源文件（如图片、配置文件）。
4. 高级配置​	编辑 .spec文件	对复杂项目进行更精细的配置，如手动指定隐藏导入[h]。

💻 动手实践

假设你有一个名为 main.py的脚本，以下是几个典型的打包命令示例：

• 生成单个可执行文件：这是最常用的方式，适合分发。
   

  pyinstaller --onefile main.py

   

   
• 为 GUI 程序打包（不显示控制台窗口）并添加图标：
   

  pyinstaller --onefile --noconsole --icon=app.ico main.py

   

   
• 包含额外数据文件：如果你的程序需要读取 config.json文件。
   

  pyinstaller --onefile --add-data "config.json;." main.py