Python 3.11 的 SyntaxError 能精准标到具体符号，因 PEP 657 在解析阶段记录每个 token 的列偏移，报错时直接渲染最窄可疑区域，不再整行模糊标注。
Python 3.11 的 SyntaxError 为什么能标到具体符号
因为 PEP 657 让解释器在解析阶段就记录每个 token 的起始列偏移，报错时直接渲染出最窄可疑区域，不再是整行糊弄你。
常见错误现象：
- 旧版本写
def foo(x, y:，报错箭头盖满整行，你得肉眼扫括号、冒号、逗号 - 3.11 会精准指向
:后面那个空格，或缺失的)位置
使用场景中要注意：
- 这种标注对模板生成、代码拼接类工具（如 Jinja、exec 构造字符串）帮助极大——错误不再淹没在长行里
- 但若用
exec("x = 1 + 2")且没传filename参数，列信息退化为 0，标注失效
运行时异常（如 KeyError、ZeroDivisionError）为什么只标子表达式
不是“显示更友好”，而是 CPython 编译器把 AST 节点的 col_offset 和 end_col_offset 精确注入了 traceback，让工具能画出 ~^^^^ 覆盖真实出错子项。
立即学习“Python免费学习笔记（深入）”；
典型表现：
-
x['a']['b']['c']报KeyError，3.10 标整行；3.11 只标x['a']下方 -
int('abc') + 42报ValueError，3.11 波浪线只打在'abc'上
但别迷信它万能：
- 动态键名不支持，比如
config[key]中的key是变量，就无法推断具体缺哪个键 - C 扩展模块（如 NumPy、Pandas 内部 C 逻辑）抛的异常，仍回落到整行标注
- Jupyter 默认用 IPython 异常处理器，可能弱化显示，加
%xmode Verbose才见原生效果
为什么有时看不到 ^ ~ 标注，明明装了 3.11
不是版本没生效，是环境或调用方式绕过了新 traceback 生成逻辑。
先验证是否真启用：
- 写个最小脚本：
def f(): return {}['missing'] + 1; f() - 运行后看输出里是否有类似
{}['missing']下方带~^^^^^^^^^的行
容易踩的坑：
- 自定义
sys.excepthook时用了老式traceback.print_exception(..., chain=False)，会关闭上下文渲染 - Windows 下用
py -3.11启动，但终端不支持 ANSI 高亮，看起来像没标注——其实位置信息已存在，只是没渲染出来 - 某些 IDE（尤其老旧插件）未适配新 traceback 字段，需更新 Python 插件或重启语言服务器
add_note() 怎么配合 traceback 一起用
add_note() 不是美化输出，是给异常对象挂载人类可读的上下文备注，和原始 traceback 一起打印出来，不依赖格式化器。
实操要点：
- 必须在异常被
raise出去前调用，比如except KeyError as e: e.add_note("检查 config.yaml server.port"); raise - 备注不会出现在
str(e)里，只在完整 traceback 中显示，且位置在错误类型之后、调用栈之前 - 不能重复追加，第二次调用会静默失败；循环里反复
add_note()会导致 traceback 堆叠大量相同备注
真正容易被忽略的是：它和 __cause__ 或 __context__ 完全无关，不改变异常链，纯属“贴纸条”行为——既不影响下游 except 捕获逻辑，也不触发任何额外开销。
