traceback 模块

在 Python 中，traceback 模块用于提取、格式化和打印异常的回溯信息（即错误发生时的调用堆栈）。它可以帮助你在日志中记录错误细节，或在程序中以字符串形式获取完整的错误信息。

常用函数

函数 说明
traceback.print_exc() 直接将当前异常的堆栈信息打印到标准错误输出（或指定文件）
traceback.format_exc() 返回当前异常的堆栈信息字符串，可被记录或打印
traceback.print_exception() 更灵活地打印异常（需传入异常对象）
traceback.extract_tb() 从回溯对象中提取堆栈条目（常用于解析逐帧信息）
traceback.format_tb() 将提取的堆栈条目格式化为字符串列表

典型用法

1. 捕获异常并打印堆栈

```python
import traceback

try:
1 / 0
except ZeroDivisionError:
traceback.print_exc() # 自动输出到 stderr
```

2. 获取异常信息字符串（用于日志）

```python
import traceback

try:
open("nonexist.txt")
except FileNotFoundError:
err_msg = traceback.format_exc()
print("错误详情:", err_msg) # 实际可写入日志文件
```

3. 结合 sys.exc_info() 手动控制

```python
import sys, traceback

try:
[1,2,3][5]
except IndexError:
exc_type, exc_value, exc_tb = sys.exc_info()
print("异常类型:", exc_type.__name__)
print("异常值:", exc_value)
# 获取堆栈帧信息
stack_summary = traceback.extract_tb(exc_tb)
print("堆栈摘要:", stack_summary)
```

4. 仅获取最后几层堆栈（限制深度）

```python
try:
recursive_func() # 假设递归过深
except RecursionError:
limited_tb = traceback.format_exc(limit=3) # 只显示最近3层
print(limited_tb)
```

注意事项

· traceback.format_exc() 在没有异常时返回 None，通常应放在 except 块内使用。
· 若需要记录完整异常（包括被抑制的异常链），可用 ExceptionGroup 或 __cause__，但 traceback 会默认展示 raise ... from ... 的关系。
· 在日志记录中，推荐使用 logging.exception("msg")，它内部会自动调用 traceback.format_exc()。

对比 traceback 与直接 print(e)

· print(e) 只显示异常的消息（如 division by zero）
· traceback.print_exc() 会显示完整的调用栈，更利于调试。

如果你需要更精细地控制堆栈条目（比如只获取文件名、行号、函数名），可以用 extract_tb()：

```python
import traceback
try:
raise ValueError("demo")
except ValueError:
tb_list = traceback.extract_tb(sys.exc_info()[2])
for frame in tb_list:
print(f"{frame.filename}:{frame.lineno} in {frame.name} -> {frame.line}")
```

这样就能清晰定位到每个调用帧。