sys.excepthook 是Python未捕获异常的最后处理钩子，仅捕获未被try/except拦截的异常，不处理SystemExit、KeyboardInterrupt和GeneratorExit。
sys.excepthook 是什么，它能捕获哪些异常
sys.excepthook 是 Python 解释器在未捕获异常冒泡到顶层时调用的回调函数。它只处理「未被 try/except 拦截」的异常，且**不处理 SystemExit、KeyboardInterrupt 和 GeneratorExit**（这些是故意设计为绕过它的）。换句话说：它不是万能兜底，而是“最后的打印出口”。如果你看到崩溃没进你的 excepthook，大概率是被中间某层 except 吃掉了，或者触发了上述三类特殊异常。
如何安全地替换默认 excepthook
直接赋值 sys.excepthook = my_hook 可以生效，但要注意两点：一是必须在所有可能抛异常的代码执行前设置；二是你的钩子函数签名必须严格为 (exc_type, exc_value, exc_traceback) 三个参数。常见错误是漏掉 exc_traceback 或返回值（它不该有返回值）。
推荐写法：
import sys
import traceback
<p>def my_hook(exc_type, exc_value, exc_tb):</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记（深入）</a>”；</p><h1>记录到文件或上报服务</h1><pre class='brush:python;toolbar:false;'>with open("crash.log", "a") as f:
traceback.print_exception(exc_type, exc_value, exc_tb, file=f)
# 仍可调用原逻辑（比如标准错误输出）
sys.__excepthook__(exc_type, exc_value, exc_tb)sys.excepthook = my_hook
关键点：
- 用
sys.__excepthook__保留原始行为，避免静默丢弃错误信息 - 不要在钩子里再抛异常，否则会触发递归调用或直接终止进程
- 避免在钩子里做耗时操作（如网络请求），因为主线程正处在崩溃路径上
多线程环境下 excepthook 不生效？这是预期行为
sys.excepthook 只对主线程有效。子线程中未捕获的异常不会触发它——Python 会直接打印 traceback 并静默退出该线程，主线程不受影响。想统一处理，必须显式为每个线程设置 threading.excepthook（Python 3.8+）或在线程启动前包装 run() 方法。
Python 3.8+ 推荐方式：
import threading
<p>def thread_hook(args):</p><h1>args 是一个命名元组：exc_type, exc_value, exc_traceback, thread</h1><pre class='brush:python;toolbar:false;'>with open("thread_crash.log", "a") as f:
traceback.print_exception(args.exc_type, args.exc_value, args.exc_traceback, file=f)threading.excepthook = thread_hook
注意：
-
threading.excepthook和sys.excepthook是两个独立机制，需分别设置 - 低于 Python 3.8 的版本没有
threading.excepthook，只能靠手动包装或使用concurrent.futures等高层抽象
为什么日志里看不到完整 traceback，或者格式乱了
常见原因是直接用 print(exc_value) 或 str(exc_value)，这只会输出异常消息，丢掉类型和栈帧。正确做法是调用 traceback.print_exception() 或 traceback.format_exception()。
另一个坑是编码问题：如果异常消息含非 ASCII 字符（比如中文路径、用户输入），而日志文件以 open(..., encoding="ascii") 打开，会抛新异常并中断日志。务必指定 encoding="utf-8"。
更稳妥的日志写法：
import traceback
import sys
<p>def safe_log_hook(exc_type, exc_value, exc_tb):
try:
with open("crash.log", "a", encoding="utf-8") as f:</p><h1>使用 format_exception 避免 print_exception 的 I/O 错误风险</h1><pre class='brush:python;toolbar:false;'> lines = traceback.format_exception(exc_type, exc_value, exc_tb)
f.writelines(lines)
except Exception:
# 连日志都写失败？至少确保 stderr 还在
sys.__excepthook__(exc_type, exc_value, exc_tb)</pre>真正容易被忽略的是：你写的钩子本身出错，就会导致整个异常处理链失效，最终退回到原始 traceback 输出——而这往往掩盖了你钩子里的真实 bug。
