PyInstaller打包的exe虽自带Python解释器，但依赖系统DLL（如msvcp140.dll），老旧Windows可能闪退；需用sys._MEIPASS获取资源路径、--add-data显式添加非代码文件、--hidden-import补全隐式模块，并注意--noconsole屏蔽输出及体积优化。
能打包，但“独立”是相对的——PyInstaller 生成的 .exe 文件自带 Python 解释器和依赖，不依赖目标机装 Python，但对系统 DLL（如 msvcp140.dll）仍有隐式要求，尤其在老旧 Windows 上可能闪退。
pyinstaller -F 打包后找不到资源文件（图片/配置/数据）
PyInstaller 把代码和模块打进可执行体，但不会自动包含你用 open("config.json") 或 cv2.imread("logo.png") 直接读取的外部文件。运行时路径也变了：__file__ 指向临时解压目录，不是 exe 所在位置。
- 用
sys._MEIPASS获取运行时真实资源根路径：import sys import os def resource_path(relative_path): if getattr(sys, 'frozen', False): base_path = sys._MEIPASS else: base_path = os.path.abspath(".") return os.path.join(base_path, relative_path) img = cv2.imread(resource_path("logo.png")) - 打包时显式添加资源：Windows 下用
--add-data "data;data"（分号分隔源路径和目标路径），Linux/macOS 改用冒号--add-data "data:data" - 避免硬编码相对路径，比如
os.path.join(os.path.dirname(__file__), "data")—— 这在打包后会指向错误位置
打包后双击黑窗一闪而过，或报 ImportError 缺模块
常见于使用了 matplotlib、PyQt5、openpyxl 等隐式导入模块的库，PyInstaller 静态分析没抓到它们。
- 加
--hidden-import显式声明：pyinstaller -F --hidden-import=matplotlib.backends.backend_tkagg main.py - 或者用
--collect-all拉整个包（体积大，但省心）：pyinstaller -F --collect-all PyQt5 main.py - 检查是否用了动态 import，比如
importlib.import_module("plugins." + name)—— 这类必须手动加--hidden-import或改写为静态导入 - 如果报
ModuleNotFoundError: No module named 'pkg_resources'，说明用了旧版setuptools，升级它：pip install --upgrade setuptools
打包 GUI 程序时不想弹黑窗口（noconsole）
加 --noconsole 是最直接的方案，但要注意副作用：
立即学习“Python免费学习笔记（深入）”；
- 它等价于 Windows 的
subprocess.CREATE_NO_WINDOW，会屏蔽所有print()和异常 traceback 输出 —— 调试时建议先不加，出错再加 - 若程序内部调用了
subprocess.run(..., capture_output=True)或需要标准输入输出，加了--noconsole后可能卡住或返回空结果 - macOS/Linux 不支持
--noconsole；对应的是--windowed（仅 macOS 有效），Linux GUI 程序默认无终端 - 真正想隐藏日志又保留调试能力？改用日志文件：
logging.basicConfig(filename="app.log", level=logging.INFO)
打包后体积过大（>50MB）或启动慢
PyInstaller 默认把整个 Python 标准库和所有依赖都塞进去，哪怕只用了 json 里的一个函数。
- 用
--exclude-module剔除明确不用的包：pyinstaller -F --exclude-module tkinter --exclude-module matplotlib main.py - 删掉
build/和dist/后重新打包 ——build/里缓存了旧依赖，不清会导致重复打包 - 检查是否误打了整个虚拟环境：确保在干净的 venv 中运行
pyinstaller，且requirements.txt只含真实依赖 - 启动慢常因首次解压耗时，可加
--upx-exclude=vcruntime140.dll（UPX 压缩某些 DLL 会触发杀毒软件误报，反而拖慢）
最易被忽略的一点：PyInstaller 生成的 dist/ 下 exe 文件，不能直接复制到另一台机器就“绝对可用”。它仍依赖系统级 C 运行时（如 vcruntime140.dll）。Win7/Win8 用户可能需手动安装 Microsoft Visual C++ Redistributable，否则双击直接无响应。
