VSCode调试需安装对应语言扩展、环境就绪且program路径正确；launch.json应通过齿轮图标自动生成；断点失效多因sourceMap缺失、工作目录错误或Service Worker缓存；WATCH和VARIABLES面板比悬停更可靠；DEBUG CONSOLE可执行当前作用域代码但会终止调试会话。
VSCode 调试器本身不自带运行时，launch.json 配置是否生效，取决于你装了对应语言的调试扩展、项目环境是否就绪、以及 program 路径是否指向可执行入口——三者缺一不可。
如何生成有效的 launch.json
别手动从头写。点击调试侧边栏顶部的齿轮图标，VSCode 会根据已安装的调试扩展（如 Python、JavaScript Debugger、C/C++）自动列出环境模板。选中后，它会生成带注释的默认配置。关键点：
-
configurations数组里每个对象代表一个启动配置，name是你在调试下拉菜单里看到的名字 -
type必须与已安装扩展声明的调试器 ID 一致，比如 Python 扩展注册的是python，不能写成Python或py -
program（或file、script）必须是相对工作区根目录的路径，且文件真实存在，比如"program": "./src/index.js" - Node.js 项目若用 ES 模块，需加
"runtimeArgs": ["--loader", "ts-node/esm"]类参数，否则断点不命中
断点为什么没停住？常见失效场景
断点灰色空心圆、悬停显示 “未绑定”，说明调试器无法将源码位置映射到实际执行代码。原因通常有：
- 源码经过构建（如 TypeScript 编译、Webpack 打包），但没生成或没加载
.map文件；检查sourceMaps是否设为true，并确认outFiles路径匹配生成的 JS 文件 - 调试器启动时工作目录不对，导致
program路径解析失败；用${workspaceFolder}显式拼接更安全 - Chrome 调试网页时，页面资源被 Service Worker 缓存，旧 JS 仍在运行；可在 DevTools 的 Application → Service Workers 中勾选
Update on reload - Python 断点打在
if __name__ == "__main__":外部的模块级代码上，而调试器运行的是另一个入口文件——断点只对当前program加载链有效
变量监视：比 hover 更可靠的方式
光靠鼠标悬停看变量容易漏掉异步或作用域外的值。真正实用的做法是：
- 在
WATCH面板里右键添加表达式，比如JSON.stringify(state)或Object.keys(obj)，支持任意 JS 表达式求值 -
VARIABLES面板里展开Local或Closure节点，能看清闭包捕获的变量，比源码里找let声明直观得多 - 对数组/对象右键选择
Copy Value，粘贴出来是 JSON 字符串，适合快速比对结构；选Copy as Expression则复制成可执行代码，方便在 DEBUG CONSOLE 里重试 - Python 调试时，
Variables面板默认不展开嵌套字典，需手动点击箭头；想全局展开，可在设置里搜debug.inlineValues开启内联显示
调试控制台（DEBUG CONSOLE）不是终端
DEBUG CONSOLE 运行在调试进程上下文中，可以调用当前作用域的函数、修改变量值，甚至触发副作用。但它和集成终端（Terminal）完全隔离：
console.log("hello"); // ✅ 可执行，输出到 DEBUG CONSOLE 底部
process.exit(0); // ⚠️ 会直接终止调试会话，不是退出终端
fetch("/api/data"); // ✅ 在 Node.js 调试中可用，但返回 Promise，需 await（按 Enter 后再输 .then(...)）
如果发现输入命令无响应，大概率是卡在异步操作里，试试加 await 或检查是否处于暂停状态。
最常被忽略的一点：每次改完 launch.json，不需要重启 VSCode，但必须重新点击「开始调试」按钮——旧的调试会话不会自动应用新配置。
