VS Code断点不触发、变量不可见或调试器未连接，根源在于语言扩展、launch.json配置及运行环境未对齐。需确认调试器启动、F5而非Ctrl+F5运行、正确设置program/cwd/env字段，并确保开发模式启用sourceMap、禁用代码优化。

VS Code 中设断点本身很简单，但真正卡住你的往往不是“怎么点”，而是断点不触发、变量看不到、或者调试器根本没连上——这些问题和你用的语言、运行方式、launch.json 配置强相关。

断点点了没反应？先确认调试器是否已正确启动

VS Code 本身不执行代码，它依赖语言对应的调试扩展（比如 Python 扩展内置 debugpy，Node.js 用 node 自带调试协议）。如果点了断点却直接跑完、控制台没进调试模式：

• 检查左下角状态栏是否显示「运行和调试」图标已激活，且当前调试配置（launch.json）选中的是你正在编辑的文件对应环境
• 确保你不是直接按 Ctrl+F5（跳过断点），而是按 F5 启动调试会话
• Python 用户注意：python.pythonPath 已弃用，新版必须在 launch.json 的 python 字段指定解释器路径，或通过命令面板选择解释器（Python: Select Interpreter）
• Node.js 用户若用 npm start 启动，需改用 node --inspect-brk 模式，否则断点在入口前就失效

为什么变量值显示为 undefined 或 not available？

这通常不是断点问题，而是作用域或优化导致的调试信息缺失：

deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

• JavaScript/TypeScript：启用 "sourceMap": true 且生成了 .map 文件；若用了 webpack 或 vite，确保开发模式下未开启 devtool: "hidden-source-map"
• Python：局部变量在 if 块内定义但未执行到该分支时，调试器不会提前渲染；函数参数名若被 exec() 或动态赋值覆盖，也可能丢失符号信息
• 所有语言：发布构建（minify、tree-shaking、-O2 编译选项）会移除调试符号，务必在开发配置下调试

launch.json 里最常配错的三个字段

这个配置文件是断点能否生效的中枢，写错一个字段就白点半天：

• "program"：必须是可执行入口的绝对路径或相对于 workspaceFolder 的路径，不能是模块名（如 "program": "app.py" ✅，"program": "python app.py" ❌）
• "cwd"：当前工作目录影响相对路径导入（比如 Python 的 import utils），不设或设错会导致模块找不到，调试器静默退出
• "env" 和 "envFile"：环境变量冲突很常见，比如 DJANGO_SETTINGS_MODULE 没传进去，Django 项目直接报 ImproperlyConfigured 而不提示你断点在哪

断点逻辑本身极简单，难的是让整个调试链路对齐：编辑器 → 扩展 → 运行时 → 源码映射。很多人反复重启 VS Code，其实只需要打开命令面板运行一次 Developer: Toggle Developer Tools，看 Console 里有没有 Cannot connect to runtime 或 Source map warning 这类线索。