Python 3.12 错误提示全面升级：NameError 主动建议导入标准库模块；ImportError 基于编辑距离推荐正确成员名；语法错误精准定位并给出修正示例；ExceptionGroup traceback 分层可读。
Python 3.12 的 NameError 提示会主动建议导入模块
当你直接使用未导入的 sys、math、pathlib 等标准库模块时，Python 3.11 只报 NameError: name 'sys' is not defined；而 Python 3.12 会在同一行末尾追加提示：Did you forget to import 'sys'?。
这个改进只对标准库模块生效，不覆盖第三方包（比如 requests 或 numpy），且在 IPython / Jupyter 中因字节码处理机制不同，该提示通常不显示。
- 触发条件：变量名恰好匹配某个标准库模块名（如
json、re、os） - 不触发场景：变量名拼写接近但不完全一致（如
syss）、或来自已安装但非标准库的包 - 注意：该提示是编译期静态分析结果，不是运行时动态检查
ImportError 现在能给出拼写建议
从 collections 导入 chainmap（小写）在 3.11 中只报 cannot import name 'chainmap' from 'collections'；3.12 则额外附带：Did you mean: 'ChainMap'?。
类似地，尝试导入 defaultdic 会被建议 'defaultdict'，导入 ordreddict 会被建议 'OrderedDict'。
立即学习“Python免费学习笔记（深入）”；
- 建议基于 Levenshtein 距离和当前命名空间内可用名称生成，仅限同模块内已有成员
- 不会跨模块推荐（例如从
itertools错输成intertools，不会提示itertools） - 第三方包的模块/成员名不参与此建议机制
语法错误提示更精准，且带修正引导
import a.b from c 这种颠倒关键字顺序的写法，在 3.11 中报错位置模糊、信息简短；3.12 不仅高亮错误片段，还直接提示：Did you mean to use 'from c import a.b' instead?。
另一个典型例子是 f-string 中的非法表达式：3.12 能准确定位到未闭合的括号或冒号，并在错误信息中用箭头指向具体字符位置，而不是笼统报 Invalid syntax。
- 所有语法类提示均基于 AST 解析阶段的上下文推断，不依赖运行时状态
- 提示文本是硬编码模板，非 AI 生成，因此不会出现“过度建议”或幻觉
- 某些边缘 case（如嵌套过深的 f-string）仍可能回退到传统错误格式
except* 异常分组提示让并发错误更可读
当代码抛出 ExceptionGroup（例如多个协程同时失败），3.11 的 traceback 会把所有异常堆在一起，难以区分；3.12 在 traceback 开头明确标注：ExceptionGroup: multiple exceptions (2 sub-exceptions)，并为每个子异常单独编号和缩进。
配合新的 except* 语法，调试时能一眼看出哪些异常被哪个 except* 分支捕获，而不是靠人工比对 traceback 行号。
- 需要显式使用
ExceptionGroup或asyncio.gather(..., return_exceptions=True)才会触发该提示 - 普通
try/except无法捕获ExceptionGroup，会直接中断程序——这点容易被忽略 - 目前 IDE 对
except*的语法高亮和跳转支持仍不完善，需留意编辑器版本
真正影响日常调试效率的，往往不是新语法多炫酷，而是错误信息里那句「Did you mean…」有没有打中你刚敲错的字母。3.12 的改进全在这些细节里，但得亲手试几次忘写 import 或拼错类名，才能体会到它省下的那几十秒到底值不值。
