因为PyInstaller默认以--windowed或--noconsole模式运行，屏蔽了stderr，未捕获异常直接退出且无日志输出；解决方法是主入口前配置logging到error.log，并用try/except包裹启动逻辑，确保崩溃前写入详细错误。
打包后程序闪退，为什么看不到报错信息
因为 PyInstaller 等工具默认以 --windowed（Windows 下）或 --noconsole（macOS/Linux）模式运行，Python 的标准错误流（stderr）被完全屏蔽，未捕获的异常直接导致进程退出，日志根本没地方输出。
这不是代码没报错，是报错被吞了。常见于：ImportError（缺失 DLL 或模块路径不对）、FileNotFoundError（资源文件路径硬编码）、AttributeError（PyQt/TKinter 初始化失败）等。
解决思路不是“等它崩了再抓”，而是让崩溃前把错误强制写进本地文件。
用 try/except 包裹主入口并重定向 sys.stderr
在你的主脚本最外层（比如 if __name__ == "__main__": 之后）加一层全局异常捕获，并把 traceback 写入固定位置的日志文件。注意：不能只依赖 sys.excepthook，因为某些 C 扩展崩溃（如 PyQt 插件加载失败）会绕过它。
立即学习“Python免费学习笔记（深入）”；
- 日志路径必须用
sys._MEIPASS或os.path.dirname(sys.executable)，避免写到只读目录（如 Program Files） - 用
logging.basicConfig+FileHandler比手动 open 更可靠（自动处理编码、换行、权限） - 务必在 import 任何可能触发崩溃的模块（如
PyQt5、cv2）之前就配置好日志
import sys
import os
import logging
import traceback
<h1>先确定日志路径：优先写入 exe 同目录</h1><p>log_path = os.path.join(os.path.dirname(sys.executable), "error.log")</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill9965" title="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20dbae7c507.jpg" alt="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill9965" title="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac">macOS UI 自动化技能包 —— 用 Python 控制你的 Mac</a>
<p>让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript
系统要求
macOS 14+ (Sonoma)
Python 3.9+
需要开启：辅助功能 + 屏幕录制权限</p>
</div>
<a href="/xiazai/skill9965" title="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><h1>配置日志（不依赖 stdout/stderr）</h1><p>logging.basicConfig(
level=logging.ERROR,
format="%(asctime)s - %(levelname)s - %(message)s",
handlers=[logging.FileHandler(log_path, encoding="utf-8")]
)</p><p>def handle_exception(exc_type, exc_value, exc_traceback):
logging.error("Uncaught exception", exc_info=(exc_type, exc_value, exc_traceback))</p><p>sys.excepthook = handle_exception</p><p>if <strong>name</strong> == "<strong>main</strong>":
try:</p><h1>⚠️ 这里才 import GUI 模块、启动主窗口等</h1><pre class='brush:python;toolbar:false;'> from myapp.main import run_app
run_app()
except Exception as e:
logging.exception("Crash at main entry")
sys.exit(1)PyInstaller 打包时禁用 --windowed 并临时调试
发布前验证日志是否真能捕获错误，最简单办法是打包时不加 --windowed（Windows）或 --noconsole（macOS/Linux）。这样控制台窗口会一直挂着，所有 print 和未捕获异常都会实时显示。
- Windows：用
pyinstaller --onefile myapp.py（不加--windowed），双击 exe 就能看到黑窗和报错 - macOS：去掉
--noconsole后，需通过终端运行./dist/myapp.app/Contents/MacOS/myapp才能看见 stdout - 确认日志文件生成且内容完整后，再加回
--windowed发布
注意：有些杀毒软件会拦截无控制台的 Python 进程，导致刚启动就退出——这种“闪退”根本不会走到 Python 异常处理逻辑，只能靠 Process Monitor（Windows）或 Console.app（macOS）查系统级错误。
资源路径错误导致的静默失败怎么定位
90% 的打包后闪退其实卡在第一步：找不到图标、配置文件、模型权重。这些错误往往发生在 import 之后、try 之前，比如 QIcon("res/icon.png") 或 open("config.json") 报 FileNotFoundError，但没被包进 exe 或路径写死了。
- 用
sys._MEIPASS替代相对路径：os.path.join(sys._MEIPASS, "icon.png") - 打包时显式添加数据文件：
pyinstaller --add-data "res;res" myapp.py（Windows 分号，macOS/Linux 用冒号） - 在日志开头加一行 dump 当前工作路径和
sys._MEIPASS值，比猜路径快十倍
别信“我本地跑得好好的”，打包后的执行环境和开发环境完全隔离——os.getcwd() 是用户双击 exe 的目录，sys._MEIPASS 才是资源解压位置，两者八成不一样。
