pyinstaller打包后闪退主因是运行时依赖缺失：未处理相对路径（需改用sys._meipass）、未显式添加非python资源（用--add-data）、目标机缺vc运行库（如vcruntime140.dll）。
PyInstaller 是目前最可靠、文档最全、社区支持最好的 Python 打包工具，绝大多数情况下直接用它就行。它不是“能用”，而是“在真实交付场景中被反复验证过可行”。
为什么打包后双击就闪退或报“failed to execute script”
这不是脚本写错了，而是 PyInstaller 没把运行时真正需要的东西带进去。常见原因有三个：
- 脚本里用了相对路径读配置/图片/模板（比如
open("config.json")），但打包后工作目录变了，得改成从sys._MEIPASS读； - 非 Python 文件（如
.json、.ico、.ttf）没显式加进包里，要用--add-data告诉它“这个也要带上”； - 目标电脑缺 Visual C++ 运行库（
VCRUNTIME140.dll等），尤其干净的 Win10/Win11 安装后必现——这不是你打包的问题，是 Windows 的事。
怎样用 --onefile 打出一个能直接发给客户的 .exe
单文件模式最方便分发，但对资源路径和依赖更敏感。关键操作如下：
- 先确保脚本在干净虚拟环境中能正常跑：
python your_script.py； - 基础命令起步：
pyinstaller --onefile --console your_script.py（加--console能看到报错，别一上来就--windowed）； - 要加图标？用
--icon=app.ico，图标必须是.ico格式，且路径正确； - 要隐藏黑窗口？等确认功能正常后再换
--windowed； - 含资源文件？Windows 下用分号分隔源路径和目标路径：
--add-data "config.json;."（表示把同目录的config.json放到 exe 解压后的根目录）。
怎样避免打出 80MB+ 的巨无霸 .exe
--onefile 默认会把整个 Python 解释器 + 所有 import 过的模块都塞进去，哪怕你只用了 requests，也会连带打包 urllib3、chardet、certifi 和大半标准库。
- 删掉不用的大模块：
--exclude-module tkinter --exclude-module matplotlib； - 检查脚本开头有没有
import *或无条件导入（比如import sys, os, json, requests, pandas全堆一起），拆开、按需导入； - 真没必要死守单文件？改用
--onedir：生成一个dist/your_app/文件夹，体积小、调试方便、资源路径也直观； - 别用 Anaconda 环境打包——它自带一堆冗余包，体积翻倍还容易冲突。
还有哪些工具值得考虑
PyInstaller 是默认选择，但如果你遇到这些情况，可以试试别的：
- 启动慢、体积大、客户抱怨“点一下等五秒” → 试
nuitka --standalone your_script.py，它把 Python 编译成 C，体积更小、启动更快、反编译门槛更高； - 只是内部用的命令行小工具，用户都有 Python 环境 → 用
shiv打个.pyz，几 MB，秒启动，不打包解释器； - 需要跨平台（macOS/Linux 也要打包）→
PyInstaller依然首选，但注意 macOS 需要 codesign，Linux 注意 glibc 版本兼容； - 看到
py2exe或cx_Freeze教程？它们没坏，只是生态更新慢、文档零散、出问题难排查，除非已有旧项目绑定，否则没必要切入。
实际交付时最容易被忽略的，是 资源路径硬编码 和 VC 运行库缺失。前者让程序在你机器上好好的，一发给别人就崩；后者导致客户刚双击就消失，连错误提示都不给。这两点不提前验，打包等于白干。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
