直接print(e)不够用，因为它只显示错误类型和简短消息，无法定位异常发生位置；必须借助traceback模块获取完整堆栈信息，如format_exc()、print_exception()或extract_tb()等函数来实现精准调试与日志记录。
为什么直接 print(e) 不够用？
遇到异常时只打印 str(e) 或 repr(e)，你只能看到错误类型和简短消息，比如 KeyError: 'name'。但真正要定位问题，得知道异常在哪一行、哪个函数、调用链路怎么走的——这必须靠 traceback 模块。Python 默认在未捕获异常时自动打印完整堆栈，但一旦你用 try...except 捕获了，就得自己调用 traceback 相关函数来还原它。
用 traceback.format_exc() 获取字符串形式的堆栈
这是最常用也最轻量的方式，适合记录日志或返回给前端（需注意敏感信息）：
try:
1 / 0
except ZeroDivisionError as e:
import traceback
stack_str = traceback.format_exc()
print(stack_str)
输出就是标准的多行堆栈文本，包含文件路径、行号、代码上下文。注意：format_exc() 只能用在 except 块内，且默认抓取当前线程最近一次异常；如果在别处调用，会返回空字符串或报错。
- 不能在
except外直接用，否则拿不到异常上下文 - 返回的是
str，可直接写入文件或传给 logging - 不包含
__cause__或__context__（即异常链），如需支持嵌套异常，得用traceback.format_exception()
用 traceback.print_exception() 直接输出到 stderr 或自定义流
当你想模拟 Python 默认的报错样式，又不想依赖 sys.excepthook，就用这个：
import traceback
try:
raise ValueError("bad input")
except ValueError as e:
traceback.print_exception(type(e), e, e.__traceback__)
关键点在于第三个参数必须是 e.__traceback__（不是 sys.exc_info()[2]，后者在 except 块里虽可用，但容易因变量重用出错）：
- 推荐始终传
e.__traceback__，它是异常对象自带的、干净的 trace object - 可指定
file=参数输出到 StringIO、文件等，比如file=open("error.log", "a") - 若要包含异常链（比如由
raise ... from ...引发的），加参数chain=True（默认值）
自定义格式：用 traceback.extract_tb() 提取结构化堆栈信息
当你要做分析、过滤、高亮某几层，或者把堆栈转成 JSON 发给监控系统，就得拆解它：
import traceback
try:
x = []
y = x[1]
except IndexError as e:
tb = e.__traceback__
frames = traceback.extract_tb(tb)
for f in frames:
print(f.filename, f.lineno, f.name, f.line)
extract_tb() 返回 TracebackException 兼容的元组列表，每个元素是 (filename, lineno, function, text)。比纯字符串更可控，但要注意：
-
extract_tb()只处理 traceback，不包含异常本身；要一起获取，用traceback.ExceptionInfo或手动拼接 - 如果用了
__cause__或__suppress_context__，得配合traceback.walk_exception()遍历整条链 - 路径可能是相对的，生产环境建议用
os.path.abspath(f.filename)统一处理
真正难的不是调哪个函数，而是决定要不要保留 __cause__、是否过滤掉框架内部帧、以及如何安全地把堆栈暴露给用户——这些没标准答案，得看场景。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
