PyInstaller打包EXE需解决路径、资源、隐式导入和工作目录四问题：用resource_path()处理资源路径，--add-data添加外部文件，--noconsole隐藏黑窗，--onefile生成单文件，并用--hidden-import补全未发现模块。
PyInstaller 能打包出真正独立的 EXE，但默认行为常导致运行时报错、找不到资源或启动黑窗——关键在于理解它如何处理路径和依赖。
打包前必须修正脚本里的相对路径
PyInstaller 会把你的脚本解压到临时目录再执行，__file__ 指向的是临时路径，不是你开发时的项目目录。硬写 "data/config.json" 或 os.path.join("images", "icon.png") 必然失败。
- 用
sys._MEIPASS判断是否在打包后运行：import sys import os <p>def resource_path(relative_path): if getattr(sys, 'frozen', False): base_path = sys._MEIPASS else: base_path = os.path.dirname(os.path.abspath(<strong>file</strong>)) return os.path.join(base_path, relative_path)</p><h1>正确用法</h1><p>config_file = resource_path("data/config.json") icon_path = resource_path("assets/icon.ico") - 所有外部文件（图片、配置、字体、数据文件）都得走这个函数，不能直接拼接字符串
- 如果用了
pkg_resources或importlib.resources，PyInstaller 默认不自动收集，得手动加--add-data
命令行参数选错会导致EXE无法运行或体积爆炸
pyinstaller 的默认模式是生成带控制台的窗口（哪怕你是 GUI 程序），而且没加 --onefile 会生成整个文件夹，不是单个 EXE。
- GUI 程序必须加
--noconsole，否则弹黑窗；命令行工具则不要加 - 要单个 EXE 就必须加
--onefile，但注意：启动稍慢（解压过程），且防病毒软件可能误报 - 需要包含额外文件（比如图片、模板）时，用
--add-data "src;dst"（Windows 用分号，Linux/macOS 用冒号）：pyinstaller --onefile --noconsole --add-data "assets;assets" --add-data "templates;templates" main.py
- 避免用
--debug发布，它会让 EXE 保留调试信息并暴露内部结构
常见报错和对应解法
打包成功不等于能运行。以下错误几乎都源于路径或隐式导入没处理好：
立即学习“Python免费学习笔记（深入）”；
-
ModuleNotFoundError: No module named 'xxx'：说明 PyInstaller 没自动发现某个库的子模块，比如matplotlib的后端或sklearn的某些 estimator。加--hidden-import=xxx，例如--hidden-import=sklearn.utils._cython_blas -
FileNotFoundError: [Errno 2] No such file or directory: 'xxx'：90% 是资源路径没走resource_path()，剩下 10% 是--add-data目标路径写错（注意目标路径是相对于 EXE 运行时的当前工作目录，不是源码目录） - EXE 双击一闪而退：没加
--noconsole且程序异常退出，或没捕获顶层异常。加try/except+input()临时卡住看报错，或改用命令行运行：cmd /c your_app.exe & pause - 打包后图标不显示：确保
--icon=xxx.ico指向的是绝对路径或相对于当前命令行路径的 .ico 文件，且图标尺寸合规（推荐 256×256 和 48×48 多尺寸嵌入）
最麻烦的从来不是打包命令本身，而是让代码“适应打包后的环境”——路径、资源、隐式导入、工作目录，四者缺一不可。漏掉任意一个，EXE 都可能在别人电脑上静默失败。
