PyInstaller打包后报“failed to execute script”主因是资源路径错误或依赖未收集：需用sys._MEIPASS定位文件、--add-data添加非Python资源、预装VC运行库解决DLL缺失，优先选--onedir和纯净虚拟环境减体积。
PyInstaller打包后运行报错“failed to execute script”
这通常不是脚本本身问题，而是 PyInstaller 没能正确收集依赖资源（比如 data 文件、配置文件、__pycache__ 外的模块路径），或者入口脚本里用了相对路径读取文件，打包后工作目录变了。
实操建议：
- 用
pyinstaller --onefile --console your_script.py先跑最简命令，确认基础可执行性 - 加
--debug=all查看启动时加载了哪些模块，快速定位缺失项 - 如果脚本里用了
open("config.json")，改成os.path.join(sys._MEIPASS, "config.json")（仅--onefile模式需要） - 用
--add-data "src/data;data"显式添加非 Python 资源（Windows 下分号分隔，macOS/Linux 用冒号）
打包后的exe在其他电脑上闪退或提示DLL缺失
PyInstaller 默认不打包某些系统级 DLL（如 VCRUNTIME140.dll、MSVCP140.dll），尤其在没装 Visual C++ 运行库的干净 Windows 系统上必然失败。
实操建议：
- 目标机器先装 Microsoft Visual C++ 2015–2022 Redistributable (x64)（推荐，一劳永逸）
- 打包时加
--runtime-hook或用windeployqt（不适用，那是 Qt 工具）——其实更直接：用--collect-all pkg_name补全可能隐式依赖的包，但对 DLL 无效 - 真正有效的做法是：打包前在目标环境最小化测试，用
depends.exe（Dependency Walker）打开生成的 exe，看标红的 DLL；再用--add-binary手动注入（不推荐，易出版本冲突） - 稳妥方案：用
--win-private-assemblies（已弃用）或直接接受“用户需预装 VC 运行库”这个事实
打包体积太大，一个空脚本打出 30MB+
--onefile 模式会把整个 Python 解释器 + 所有依赖打包进单个 exe，哪怕只用了 requests，也会带入 urllib3、chardet、certifi 等全套依赖，再加上 Python 标准库压缩后仍占大头。
实操建议：
- 用
--exclude-module tkinter、--exclude-module matplotlib干掉明确不用的大型模块 - 避免在脚本开头无条件
import *或批量导入，PyInstaller 会把所有被 import 的模块都拉进来 - 改用
--onedir模式：生成一个文件夹，里面含 exe +_internal目录，体积略小，且方便调试资源路径 - 别用 Anaconda 环境打包 —— 它自带几百 MB 的冗余包，用
python -m venv myenv新建纯净环境再pip install必需依赖
如何让打包后的程序支持多语言或读取外部配置而不重打包
硬编码文本或把配置写死在 Python 里，每次改都要重新打包，违背“一次打包、多处运行”的初衷。关键是把可变部分抽离为外部文件，并确保打包后仍能定位。
实操建议：
- 配置文件（如
settings.yaml）放和 exe 同级目录，启动时用os.path.dirname(sys.executable)获取 exe 所在路径 - 多语言字符串用
gettext+.mo文件，把locale目录用--add-data "locale;locale"加进去 - 避免用
__file__获取当前路径 —— 在--onefile模式下它指向临时解压路径，且每次不同 - 若必须内置默认配置，可用
pkgutil.get_data(__name__, "default.conf")把配置当包资源加载（需放在 package 内）
PyInstaller 看似一键，实际跨环境运行的核心从来不是“能不能打出来”，而是“资源路径怎么稳、依赖边界怎么控、目标机环境怎么兜底”。很多问题表面是打包失败，根子在脚本设计阶段就没考虑可移植性。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
