Python 3.10与3.12在错误信息提示的友好度上有何改进？-Python教程-PHP中文网

python 3.12 错误提示全面升级：nameerror 主动建议导入标准库模块；importerror 基于编辑距离推荐正确成员名；语法错误精准定位并给出修正示例；exceptiongroup traceback 分层可读。

python 3.10与3.12在错误信息提示的友好度上有何改进？

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'。

建议基于 Levenshtein 距离和当前命名空间内可用名称生成，仅限同模块内已有成员
不会跨模块推荐（例如从 itertools 错输成 intertools，不会提示 itertools）
第三方包的模块/成员名不参与此建议机制

语法错误提示更精准，且带修正引导

import a.b from c 这种颠倒关键字顺序的写法，在 3.11 中报错位置模糊、信息简短；3.12 不仅高亮错误片段，还直接提示：Did you mean to use 'from c import a.b' instead?。

Li Python Sec Check

Python 安全规范检查工具：基于 CloudBase 规范、腾讯安全指南，LLM 智能分析（默认禁用，优先本地执行）

下载

另一个典型例子是 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 行号。