vscode调试需主动设断点、控执行流、查变量，断点仅在实际执行的同步逻辑行生效；空心红点因函数未调用、异步未触发或sourcemap缺失；watch和debug console可深度查看变量；call stack缺失函数说明未执行；launch.json配置错误将导致调试失败。
VSCode调试不是“点一下就自动修 bug”，它需要你主动设断点、控执行流、查变量状态——但只要配对关键步骤，定位错误比console.log快得多。
断点加在哪才真正生效？
断点只在**实际会执行的同步逻辑行**上起作用。函数没被调用、异步回调还没进、或代码被构建工具优化掉时，红点会变为空心，说明调试器找不到对应源码位置。
- 确保断点打在函数体内部、而非声明行（比如
function foo() {这行不能打断点） - TypeScript/前端项目中，
launch.json里的program必须指向构建后文件（如./dist/index.js），而不是.ts源码 - 空心红点？检查
sourceMaps是否为true，且构建输出目录下存在.map文件
变量看不全？别靠悬停，用WATCH和DEBUG CONSOLE
左侧面板的VARIABLES默认只展开一层对象；悬停也只显示基础类型值。对Promise、大型数组或嵌套很深的响应（如res.data.items[0].name），悬停常显示[object Promise]或截断内容。
- 在
WATCH面板点+号，手动输入表达式，比如error.stack可看到完整堆栈 - 对复杂结构，直接在
DEBUG CONSOLE里输入JSON.stringify(obj, null, 2)格式化查看 - 修改变量值？右键变量名 →
Set Value（快捷键F2），回车确认
为什么CALL STACK里找不到我的函数？
调用栈显示的是当前暂停点的完整函数链。如果点击事件没触发、API没进回调、或setTimeout没执行，很可能根本没走到你预期的位置。
- 点
CALL STACK里的任意帧，VSCode会跳转到对应源码行——这是确认“到底进了哪一层”的最快方式 - 若某函数完全没出现在栈里，说明它压根没被调用（检查绑定逻辑、条件分支、或是否被
return提前跳出） - 多线程场景（如Julia、Python多进程）需注意：不同线程有独立调用栈，需在调试面板切换线程上下文
launch.json配错会导致整个调试失败
没有launch.json，VSCode只能尝试运行当前文件；但多数真实项目依赖特定入口、参数或环境变量，这时配置错误会直接导致Cannot connect to the target或调试器秒退。
- Node.js项目常用：
"program": "${workspaceFolder}/src/index.js"，别写成.ts或漏掉路径变量 - Python项目要确认
"module"或"file"字段指向正确入口，且"env"里补全PYTHONPATH（尤其涉及包导入时） - 远程调试（SSH/WSL/容器）必须保证调试适配器在远端已安装，日志里出现
Could not find debug adapter就是这个原因
最常被忽略的点：断点生效的前提是代码真正在当前上下文中执行——不是所有红点都会停，也不是所有console.log都能替代WATCH里的一行表达式求值。
