• 易用性：直接打包Python脚本为独立可执行文件，无需修改代码。
• 跨平台：支持Windows、macOS、Linux（但exe仅限Windows）。
• 依赖处理：自动分析依赖（包括隐藏导入），支持数据文件（如图片、配置）的打包。
• 输出：生成单个exe或带依赖的文件夹，体积较大（因包含解释器和库）。
• 反编译风险：生成的exe可被反编译，需配合代码混淆增强安全性。

适用场景：

• 快速打包小型工具或内部使用程序。
• 目标用户环境复杂，需兼容旧版Python或第三方库。
• 不追求极致性能或启动速度。

1.1 安装 PyInstaller

pip install pyinstaller

升级最新版：

pip install --upgrade pyinstaller

1.2 基本用法

将 Python 脚本打包为可执行文件：

pyinstaller main.py

1.3 常用参数

• -F / --onefile

将所有依赖打包成单个可执行文件（默认生成多个文件）

pyinstaller --F main.py

• -D / --onedir

生成一个目录（默认行为），包含可执行文件和依赖（与 --onefile 互斥）

• -n NAME / --name=NAME

指定生成的可执行文件名称（默认使用脚本名）

pyinstaller -n MyApp main.py

• -w / --windowed / --noconsole

隐藏命令行窗口（适用于 GUI 应用）

pyinstaller -w main.py

• --icon=ICON.ico

设置可执行文件的图标（仅 Windows/macOS）

pyinstaller --icon=logo.ico main.py

• --add-data="SRC;DEST"

添加额外文件或目录（格式因平台而异，注意 ; 和 : ）

# Windows:pyinstaller --add-data "data.txt;." main.py# Linux/macOS: pyinstaller --add-data "data.txt:." main.py

• --exclude-module=MODULE

排除不需要的模块（减少体积）

pyinstaller --exclude-module=numpy main.py

• --hidden-import=MODULE

强制包含未被自动检测到的模块

pyinstaller --hidden-import=pandas main.py

pyinstaller --version-file=version.rc main.py

pyinstaller --debug main.py

pyinstaller --clean script.py

pyinstaller -F -w --icon=app.ico --add-data "config.ini;." main.py

# main.spec 示例block_cipher = Nonea = Analysis(    ['main.py'],    pathex=['/path/to/script'],    binaries=[],    datas=[('data.txt', '.')],    hiddenimports=['pandas'],    hookspath=[],    runtime_hooks=[],    excludes=[],    win_no_prefer_redirects=False,    win_private_assemblies=False,    cipher=block_cipher,    noarchive=False,)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,    upx_exclude=[],    runtime_tmpdir=None,    console=True,    icon='logo.ico',)

pyinstallermain.spec