launch.json 必须配置 type 为 "python"（小写），并确保安装官方 Python 扩展、解释器路径正确、启动方式（module/file）匹配实际运行逻辑，且左下角 Python 解释器与配置一致。
launch.json 里必须配 python 类型的配置，不是 coreclr 或 node
VSCode 的 Debug 功能依赖 type 字段识别调试器。Python 项目如果误用了其他语言的配置模板（比如从 Node.js 项目复制过来），launch.json 里写成 "type": "node"，断点会完全不生效，控制台也看不到 Python 进程启动日志。
- 确认
type是"python"，大小写敏感，不能写成"Python"或"PYTHON" - 确保已安装官方
Python扩展（Microsoft 出品），仅装 Pylance 不够 - 如果用的是 Conda 环境，
python路径要指向环境内的解释器，比如/opt/anaconda3/envs/myenv/bin/python，不是系统默认的/usr/bin/python3 - Windows 用户注意路径斜杠：用正斜杠
/或双反斜杠\，单反斜杠会导致 JSON 解析失败
断点不触发？检查 module 和 file 启动方式是否匹配实际运行逻辑
很多人写好 launch.json 后打上断点，F5 启动却没停住——常见原因是启动方式和代码实际执行路径不一致。VSCode 支持两种主流启动模式：module（如 -m http.server）和 file（直接运行脚本），但它们对工作目录、sys.path、相对导入的影响完全不同。
- 用
"module": "my_package.main"时，VSCode 会以模块方式执行，要求my_package在PYTHONPATH或当前工作目录下可 import；此时断点只能打在my_package/内部文件，不能打在顶层脚本里 - 用
"program": "./src/main.py"时，VSCode 直接调用解释器执行该文件，工作目录是cwd指定路径（默认是 workspace 根目录），相对路径导入容易报ModuleNotFoundError - 调试 Flask/FastAPI 时，务必用
"module": "flask"+"args": ["run", "--no-debugger"]，而不是把app.py当program——否则热重载失效，且断点只在首次加载时有效
变量监控和调用栈正常，但局部变量显示 <not available>
这通常不是配置问题，而是 Python 解释器优化或调试器限制导致的。CPython 在某些场景下不会保留局部变量符号信息，尤其当代码被 exec()、eval() 动态执行，或函数被 @lru_cache / @property 包裹时。
- 函数内联或尾调用优化（虽 CPython 默认不启用，但 PyPy 或某些编译模式下可能触发）会让帧对象丢失局部变量引用
- 使用
del variable_name显式删除后，该变量在调试器中立即变为<not available>，不是 bug，是符合预期的行为 - 异步函数（
async def）中，await表达式后的局部变量有时延迟出现，多按一次 F10 步进即可刷新 - 如果整个作用域都显示不可用，检查是否启用了
"justMyCode": true（默认值）——它会跳过标准库和 site-packages，但若你正在调试自己安装的包，需设为false并配合"skipFiles"排除无关路径
修改 launch.json 后断点仍不生效，先看 VSCode 左下角的 Python 解释器状态
VSCode 左下角状态栏有个 Python 版本号（比如 Python 3.11.5 ('venv')），这个选择直接影响 launch.json 中所有路径解析和依赖查找。很多人改完配置却忘了切换解释器，结果调试器还在用旧环境启动。
立即学习“Python免费学习笔记（深入）”；
- 点击该区域，选择正确的 interpreter —— 必须和
launch.json中python字段指向的解释器一致，否则pip install的包找不到，breakpoint()也会静默忽略 - 如果项目含多个
.vscode/launch.json（比如根目录和子文件夹都有），VSCode 默认只读最靠近当前打开文件的那个，别以为改了根目录的就全局生效 - 修改
launch.json后无需重启 VSCode，但必须重新点击「开始调试」（F5），不能靠「重启会话」——后者复用旧的进程上下文，可能卡在旧配置里
