点赞标记，明天就能用上这几个技巧！
linux 运维、shell、python、网络爬虫、数据采集等定定做，请私信。。。

PyInstaller 打包说明（中文指南）

下面按 准备 → 基本使用 → 常用参数 → 进阶技巧 → 常见问题 的顺序，系统地介绍如何使用 PyInstaller 将 Python 程序打包成可执行文件（.exe / 可执行二进制）。

1 环境准备

2 基本使用

2.1 单文件（One-File）模式

pyinstaller -F your_script.py

• -F / --onefile：把所有依赖压缩进一个 .exe（启动时会临时解压到 %TEMP%）。
• 生成目录结构（默认在当前工作目录）：

your_script.spec
build/# 编译中间文件，可删除
dist/
your_script.exe# 目标可执行文件

2.2 多文件（One-Dir）模式（默认）

pyinstaller your_script.py

• 生成 dist/your_script/ 目录，里面包含 exe、DLL、Python 库等，便于调试。

2.3 常用快捷方式

• 打开控制台查看错误（不加 -w）

pyinstaller -c your_script.py# -c == --console

• 添加图标（Windows .ico、macOS .icns）

pyinstaller -F -i app.ico your_script.py

3 常用参数一览（推荐组合）

4 进阶技巧

4.1 使用.spec文件自定义

第一次运行 pyinstaller your_script.py 会生成 your_script.spec。可以手动编辑后再次打包：

pyinstaller your_script.spec

常见编辑点：

a = Analysis(
['your_script.py'],
pathex=['.'],
binaries=[],
datas=[
('data/config.yaml', 'data'),# 把 data 目录打进去
('resources/', 'resources')# 整个文件夹
],
hiddenimports=['pkg.module'],
hookspath=[],
runtime_hooks=[],
excludes=[],
win_no_prefer_redirects=False,
win_private_assemblies=False,
cipher=block_cipher,
)

4.2 兼容临时解压路径（单文件模式）

打包后运行时，资源文件会被解压到 sys._MEIPASS。如果代码中需要读取本地文件，推荐使用：

import sys, os

def resource_path(relative):
"""在普通运行和 PyInstaller 打包后都能得到正确路径"""
base = getattr(sys, '_MEIPASS', os.path.abspath('.'))
return os.path.join(base, relative)

4.3 多平台打包

• Windows → Linux：需要在对应系统下重新执行 pyinstaller（交叉编译不支持）。
• macOS：使用 --windowed 生成 .app，或 -F 生成单文件可执行。
• Linux：常用 --onefile + --add-data，并确保目标机器有相同的 glibc 版本。

4.4 打包 GUI 框架

5 常见问题 & 排查思路

快速定位缺失文件：

# Windows PowerShell
Get-ChildItem -Recurse -Filter "xxx.dll"
# Linux/macOS
find . -name "xxx.so"

6 打包完整示例（以 Tkinter 程序为例）

# 1 创建虚拟环境并安装依赖
python -m venv venv
venv\Scripts\activate
pip install pillow# 示例依赖
pip install pyinstaller

# 2 编写 main.py（假设使用了 data/config.yaml、images/logo.png）

# 3 打包命令
pyinstaller -F -w \
--icon=logo.ico \
--add-data "data/config.yaml;data" \
--add-data "images/logo.png;images" \
--hidden-import=pkg_resources \
--collect-all=pillow \
main.py

• 打包完成后，dist/main.exe 即可直接双击运行，所有资源已内嵌。

小结

1. 准备好环境 → 安装 pyinstaller。
2. 基本命令：pyinstaller -F your_script.py（单文件）或 pyinstaller your_script.py（目录）。
3. 常用参数：图标、数据文件、隐藏导入、排除模块、调试。
4. 进阶：编辑 .spec、兼容 sys._MEIPASS、不同 GUI 框架的特殊处理。
5. 排错：先打开控制台模式查看错误信息，再根据报错添加 --hidden-import、--add-data 等。

如果你已经有具体的项目（比如使用了 nicegui、PyQt5、或需要打包成单文件并放到特定目录），可以把项目结构或关键依赖告诉我，我可以帮你写出最合适的 PyInstaller 命令或 .spec 配置示例。

linux 运维、shell、python、网络爬虫、数据采集等定定做，请私信。。。
都看到这里了， 记得帮忙一键三连， 点赞、评论、收藏、关注