直接print(e)只显示错误消息而不显示堆栈，因为exception实例仅包含错误类型和消息，不包含调用链；堆栈信息需通过traceback模块显式提取，如在except块内调用traceback.print_exc()打印完整堆栈，或用traceback.format_exc()返回带文件名、行号、函数名的字符串用于日志等场景。
为什么直接 print(e) 只显示错误消息，不显示堆栈？
因为 Exception 实例（比如 e）默认只包含错误类型和消息，不包含调用链。堆栈信息实际由解释器在异常抛出时生成，但需要显式提取——traceback 模块就是干这个的。
常见误区是写 print(e) 或 str(e)，结果只看到 ValueError: invalid literal for int()，完全不知道错在哪一行、哪一层函数里。
- 要用
traceback.print_exc()打印当前异常的完整堆栈（必须在except块内调用） - 如果想捕获后转成字符串处理（比如写日志），用
traceback.format_exc()，它返回str -
traceback.print_exception(type, value, tb)更底层，一般不需要——除非你手动捕获了sys.exc_info()
如何在 except 里打印带行号和函数名的完整堆栈？
最常用也最安全的方式就是 traceback.print_exc()，它自动读取最近一次异常的 traceback 对象：
try:
int("abc")
except ValueError:
import traceback
traceback.print_exc()
输出会包含：错误类型、消息、完整文件路径、行号、函数名、触发行代码（带箭头指示）。注意：print_exc() 默认输出到 sys.stderr，不影响正常 print 输出流。
- 想输出到其他地方（比如文件或字符串），加参数
file=，例如traceback.print_exc(file=open("error.log", "a")) - 想限制打印深度（比如只看最后 3 层），用
limit=3 - 不要在
except外调用print_exc()，否则报ValueError: no traceback
format_exc() 和 print_exc() 有什么关键区别？
print_exc() 直接输出；format_exc() 返回字符串，适合存档、发邮件、打日志等场景：
try:
1 / 0
except ZeroDivisionError:
import traceback
err_str = traceback.format_exc()
print(f"捕获异常：\n{err_str}")
二者参数一致（limit、chain 等），但行为不同：
-
format_exc()返回的是带换行符的str，可直接拼接到其他文本里 -
chain=False可禁用 PEP 3134 的异常链展开（Python 3.3+ 默认开启，会显示During handling of the above exception...这类提示） - 如果用 logging 记录，推荐
logging.exception("msg")—— 它内部就调用了format_exc()，比手动组合更可靠
为什么有时看到的堆栈里没有你自己写的函数？
常见于使用了装饰器、异步框架（如 asyncio）、或第三方库封装调用的情况。本质是 traceback 只反映实际执行栈，而某些结构会截断或重置它。
例如 @lru_cache 或 FastAPI 的依赖注入，可能让原始出错行被“藏”在内部帧里。这时可以：
- 用
traceback.print_exc(limit=None)强制显示全部帧（默认只显示 100 层） - 检查是否启用了优化模式（
python -O），它会剥离assert和部分调试信息，影响 traceback 可读性 - 在 IDE 中调试时，别只信控制台输出——直接设断点看
sys.exc_info()[2]更准
真正难排查的，往往不是怎么打印堆栈，而是堆栈里混着 C 扩展、协程调度器或 JIT 编译层——这时候得结合 faulthandler 或 sys.settrace 深挖。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
