Python 3.11 的 ImportError 和 ModuleNotFoundError 提供更精准的错误定位：traceback 标出触发失败的具体子表达式（如模块名或符号），并附带 Note 解释缺失路径原因，得益于 PEP 657 的 AST 列偏移注入。
ImportError 和 ModuleNotFoundError 在 Python 3.11 中的 traceback 不再只告诉你“找不到模块”，而是能指出**具体哪一行、哪个子表达式触发了失败导入**，尤其在动态导入、条件导入或嵌套 from ... import ... 场景下更明显。
ImportError 的 traceback 现在标出实际执行点，而非仅顶层语句
旧版本（如 3.10）遇到 from requests import Session 失败时，traceback 只标整行；3.11 会把波浪线精准打在 requests 上（如果是包名缺失），或打在 Session 上（如果是符号未导出）。这是因为 PEP 657 让 AST 节点的列偏移信息被注入到 import 相关异常中。
常见错误现象：
- 写
from mypkg.submod import func_a, func_b，但func_b未在submod中定义 → 3.11 标出func_b，而非整行 -
importlib.import_module("unknown.package")报错 → traceback 显示"unknown.package"字符串本身被标亮，方便确认拼写
ModuleNotFoundError 显示缺失路径的上下文
当模块路径存在但解析失败（比如 sys.path 缺少父目录、__init__.py 缺失、或命名冲突），3.11 的 ModuleNotFoundError 会在 traceback 中附带一行 Note：
ModuleNotFoundError: No module named 'foo.bar' Note: 'foo' is not a package, and 'foo.py' was not found on sys.path.
这比旧版本干巴巴的 No module named 'foo.bar' 多了可操作线索。它不是猜测，而是解释器在 import 查找链中实际走到哪一步、卡在哪一环。
使用场景中要注意：
创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。
- 该 Note 仅在标准 import 机制路径中触发，绕过解释器的 C 扩展（如某些打包工具重写的 import hook）不生效
- 若用
exec()动态执行含 import 的字符串，且未传filename参数，Note 会退化为无上下文的原始错误
动态导入（importlib）也能受益于列级标注
importlib.util.spec_from_file_location() 或 importlib.util.module_from_spec() 报错时，3.11 会尝试将异常源头映射回调用位置——前提是调用栈里有 Python 层代码，且源码以文本形式加载。
实操建议：
- 避免在
try/except中捕获后仅写raise（无参），这会丢弃原始 traceback 和列信息；改用raise e from None或直接不 re-raise - 调试时别依赖
str(e)—— 它不包含 Note 和波浪线；要看到完整信息，得让异常未被捕获，或用traceback.print_exception() - 在 VS Code 中确保 Python 扩展是最新版（209M+ 用户验证的 3.14.3 版），否则可能因语言服务器未适配而渲染不全
容易被忽略的限制条件
PEP 657 的 import 错误定位能力不是万能的：
- 它对
__import__()的底层调用不生效，因为那是纯 C 实现路径 - 如果模块名来自变量（如
importlib.import_module(module_name)），错误仍指向函数调用本身，无法推断module_name的值 —— 这和KeyError对动态键名的限制一致 - Windows 终端默认不渲染 ANSI 颜色和波浪线，但位置信息仍在；可用
py -3.11 -c "import bad"验证输出是否含^^^^^或~~~~~字符
真正起作用的是解释器在编译期记录的 token 位置，不是运行时“猜”的结果；所以只要源码文件真实存在、没被混淆或压缩，import 错误就能比以前更准地告诉你——不是“哪里错了”，而是“错在哪里”。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
