vscode断点调试需配置prelaunchtask以防运行旧二进制，启用debug.allowbreakpointseverywhere支持.s等文件断点，条件断点须作用域内变量且表达式正确，python/c++/node.js需分别处理justmycode、-g编译选项和sourcemaps。

VSCode断点调试不需要手动配置 launch.json 就能跑起来，但跳过这步容易在改完代码后还运行旧二进制——你看到的“没生效”，其实是没重新编译。

断点设置失败：.S 汇编文件或某些语言不响应点击

VS Code 默认对部分文件类型（如 .S）禁用断点支持。这不是 bug，是安全限制。

• 打开设置（Ctrl+, 或 Cmd+,），搜索 debug.allowBreakpointsEverywhere
• 勾选该项，让断点可设在任意文件类型中
• 重启 VS Code，再试点击行号左侧空白处

注意：启用后，断点仍需对应语言有调试器支持（比如汇编需搭配 GDB + QEMU 配置），否则仅能设点，无法真正暂停执行。

条件断点不触发：表达式写错或作用域不对

条件断点失效最常见原因是表达式求值为 false，或变量根本不可见。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 条件表达式必须是当前作用域内可访问的变量或计算结果，例如在函数内部不能直接引用 for 循环外声明的 i
• 避免使用未定义变量，比如写 user.id === "admin" 前，先确认 user 已初始化且非 null
• 字符串比较用严格相等 ===，不用 ==；布尔值直接写 isLoading，别写 isLoading === true
• 右键断点 → “编辑断点” → 修改表达式后务必按回车确认，光标离开不保存

改了代码却还在调试旧版本：漏配 preLaunchTask

尤其对 C/C++、Go 等需编译的语言，VS Code 不会自动重编译——它只运行上次生成的可执行文件。

• 在 launch.json 中添加 "preLaunchTask": "tast gcc"（名称必须和 tasks.json 里 label 完全一致）
• tasks.json 中确保 command 指向真实编译器（如 g++），且 args 包含 -g（生成调试信息）
• Python/Node.js 项目虽常免配，但若用了自定义构建流程（如 Babel、PyInstaller），同样需要 preLaunchTask 或 postDebugTask

调试时看不到变量值：justMyCode 或优化干扰

变量面板为空或显示 Unable to retrieve variable，大概率是调试器被源码映射或编译优化拦住了。

• Python 用户检查 launch.json 是否含 "justMyCode": true（默认值），设为 false 可查看库代码中的变量（慎用，会变慢）
• C/C++ 用户确认编译参数含 -g 且不含 -O2 / -O3；-O1 有时也导致局部变量丢失
• Node.js 用户若用 TypeScript，确保 sourceMaps 为 true，且 .js 文件旁存在对应 .js.map

最易被忽略的一点：断点设在异步回调、事件监听器或定时器内部时，变量作用域可能比你想象中更窄——别只盯着函数名，要看 debugger 实际停在哪一行、当前调用栈顶部是什么上下文。