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？
这通常不是断点问题，而是作用域或优化导致的调试信息缺失：
- 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 这类线索。
