Python 3.10 错误提示显著提升可读性与精准度：SyntaxError 精确到 token 级并定位真实缺失位置；NameError/AttributeError 基于 Levenshtein 距离推荐相似名称；IndentationError 明确指出期望的代码结构。

SyntaxError 指向括号实际缺失位置，而不是下一行；NameError 和 AttributeError 会给出拼写相近的候选名——这直接减少了“找错在哪”和“是不是打错了”的反复验证时间。

错误提示精准到 token 级别，不是行级别

以前遇到 SyntaxError: invalid syntax，箭头常指向下一行开头，让人误以为问题在那行；Python 3.10 把箭头精确压在出错的 token 上。比如写 if x > 10 print("ok")，提示会把 ^ 对准 print 前面，明确告诉你缺冒号，而不是让你检查下一行。

• 真实错误位置和提示位置一致，省去逐行回溯
• 对嵌套括号（如 dict 或 list 初始化）能定位到未闭合的那个 { 或 [，而非报错在末尾
• IDE（如 VS Code、PyCharm）依赖此信息做实时高亮，效果比 3.9 更可靠

NameError 和 AttributeError 自动推荐相似名称

当访问不存在的变量或属性时，解释器不再只抛出“name 'xxx' is not defined”，而是尝试模糊匹配已有名称。例如把 user_name 错写成 username，提示里会附带 Did you mean: user_name?。

Shadows Python Sensei

Python 最佳实践助手——代码规范、设计模式、性能优化、测试与类型注解。适用于编写或审查 Python 代码。

下载

• 推荐基于 Levenshtein 距离计算，对大小写、下划线变化敏感
• 仅对当前作用域内已定义的名称生效，不会跨模块猜测
• 若存在多个候选（如 user_name、user_nam、user_names），只列最接近的一个，避免干扰

缩进错误提示说明“期望什么结构”

IndentationError 不再只说“unindent does not match any outer indentation level”，而是补充类似 expected an indented block after 'if' statement 的上下文。

• 明确告诉你“这里该接一个缩进块”，而不是让你猜是 if、for 还是 def 后漏了内容
• 对多层嵌套中混用空格和 Tab 的情况，会指出冲突发生在哪一级缩进
• 在 IDLE 或终端中，该提示与语法高亮联动，更容易视觉定位

真正卡住人的往往不是“错在哪”，而是“错得不像错”——比如少个冒号却报错在下一行，或拼错变量名后满屏搜不到定义。Python 3.10 的提示不追求炫技，只做一件事：让错误信息和你脑子里的疑问对上号。这点在快速迭代或协作调试时，比任何文档都管用。