要用 PyInstaller 打包出真正的单个 EXE 文件，必须使用 --onefile 参数，并处理隐式导入、资源路径（通过 resource_path() 函数）和第三方库兼容性问题。
PyInstaller 能把 Python 脚本打包成单个 exe 文件，但默认生成的是带依赖目录的“目录模式”，想真·单文件必须加 --onefile 参数，且得提前处理好路径、资源、第三方库兼容性问题。
怎么用 PyInstaller 打包出真正的单个 EXE 文件？
默认运行 pyinstaller script.py 会生成 dist/script/ 目录，里面包含 script.exe 和一堆 DLL、pyd 文件——这不是单文件。要真正打包成一个 .exe，必须显式加 --onefile：
pyinstaller --onefile script.py- 加
--console（或--noconsole）控制黑窗口是否显示，GUI 程序通常要--noconsole - 加
--icon=icon.ico可指定图标，注意路径必须存在且是 .ico 格式 - 加
--name=myapp可重命名输出的 EXE 文件名
打包后，最终产物只有一个 dist/myapp.exe（Windows 下），但要注意：它启动时仍会临时解压到 %TEMP%/_MEIxxx/ 目录，这是正常行为，不是失败。
打包后运行报错 “ModuleNotFoundError” 或找不到模块怎么办？
PyInstaller 不会自动分析动态导入（比如 importlib.import_module、__import__）、字符串形式的模块名，或某些包内隐藏的子模块（如 pkg_resources、matplotlib 的后端）。常见现象是 EXE 运行时报 ModuleNotFoundError: No module named 'xxx'。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
立即学习“Python免费学习笔记（深入）”；
- 用
--hidden-import=xxx显式声明缺失模块，例如：pyinstaller --onefile --hidden-import=pkg_resources --hidden-import=matplotlib.backends.backend_tkagg script.py - 对使用了
importlib动态加载的模块，最好在代码里加 dummy import（哪怕不调用），让 PyInstaller 能静态扫描到 - 某些包（如
openpyxl、scipy）自带 hook，但版本更新后可能失效，可查site-packages/pyinstaller/hooks/看是否有对应hook-xxx.py
打包后读取数据文件或资源失败，路径怎么写才对？
脚本开发时用 os.path.join(os.path.dirname(__file__), "data.csv") 是 OK 的，但打包成 --onefile 后，__file__ 指向的是临时解压路径（类似 C:\Users\...\AppData\Local\Temp\_MEIxxx\script.py），而资源文件并不在那——它们被一起打包进 EXE，运行时需用 PyInstaller 提供的 _MEIPASS 机制定位。
- 统一用这个函数获取资源根路径：
import sys
import os
<p>def resource_path(relative_path):
"""获取资源文件绝对路径，兼容开发环境和打包后"""
if getattr(sys, 'frozen', False):</p><h1>打包后的路径</h1><pre class='brush:python;toolbar:false;'> base_path = sys._MEIPASS
else:
# 开发时路径
base_path = os.path.abspath(".")
return os.path.join(base_path, relative_path)使用示例
data_file = resource_path("data/config.json") with open(data_file, "r") as f: config = json.load(f)
- 图片、配置、模板等所有非 Python 源码的文件，都得走这个
resource_path()，不能硬编码相对路径 - 如果用了
--add-data（Windows 下格式为--add-data "src;dst"），dst就是resource_path()中的相对路径前缀
打包大程序时卡住、内存爆掉或生成 EXE 过大怎么缓解？
--onefile 模式会把整个 Python 环境 + 所有依赖压缩进一个 EXE，容易导致编译慢、内存占用高、最终文件臃肿（动辄 50MB+）。这不是 bug，是设计使然。
- 用
--exclude-module=xxx排除明确不用的模块，比如--exclude-module=tkinter（如果你没做 GUI） - 避免打包整个
numpy或pandas的测试/文档子模块，它们常被误引入；检查import语句是否精简 - 加
--upx=True（需提前安装 UPX 工具）可显著压缩体积，但部分杀软会误报，生产环境慎用 - 若程序本身不大但依赖重，考虑改用
--onedir+ 自解压脚本分发，反而更稳定
真正麻烦的不是打包命令本身，而是资源路径、隐式依赖、运行时临时目录这三处——多数崩溃都发生在这儿，而不是“为什么打不出来”。
