条件断点需右键已有红点断点→选“edit breakpoint”→输入js表达式(如a>5),仅当表达式为true时暂停;变量须在当前作用域内,禁用副作用操作。

右键断点选“Edit Breakpoint”输表达式
条件断点不是靠左键点击设置的,必须右键已存在的断点(红点)→ 选择 Edit Breakpoint → 在弹出框里输入 JavaScript 表达式。VS Code 会实时校验语法,但不会检查变量是否存在——如果表达式里用了未声明或作用域外的变量,运行时直接跳过,不报错也不提示。
常见错误现象:断点图标没变、程序从不暂停。大概率是表达式写错,比如用了 == 而非严格相等 ===,或变量名拼错、大小写不符(user.id ≠ user.ID)。
- 表达式必须求值为
true才触发,null、undefined、0、空字符串都算false - 支持访问当前行所在作用域的局部变量、参数和全局变量,但不能跨函数访问私有变量
- 不要在表达式里调用有副作用的函数(如
console.log()或修改状态),调试器不保证执行顺序
条件断点失效的三个典型原因
断点图标变成带感叹号的橙色三角形,或者干脆没反应,通常不是 VS Code 坏了,而是环境或配置卡在某个环节:
-
launch.json里没启用源映射(sourceMaps: true),尤其在 TypeScript、Webpack 或 Babel 构建项目中,断点实际打在生成代码上,条件表达式却按源码作用域求值,变量名对不上 - 调试器类型配错:Node.js 项目用了
type: "pwa-node"却没装js-debug插件;Go 项目用了type: "node"—— 类型不匹配会导致条件表达式被忽略 - 断点设在异步回调里(如
setTimeout、Promise.then),而调试器没开启breakOnCaughtExceptions或没勾选“Async”选项,导致条件判断根本没机会执行
替代方案:Logpoint 比条件断点更轻量
如果你只是想观察某次循环或某次调用的变量值,又不想中断流程,Add Logpoint 是更稳的选择。右键行号 → Add Logpoint → 输入类似 i={i}, user={user?.name} 的模板字符串。它不暂停执行,日志直接输出到「调试控制台」,且变量访问逻辑比条件断点宽松(允许可选链、默认值等)。
注意:Logpoint 不支持复杂逻辑判断(比如 i > 10 && user.active),它只做插值输出。真要过滤,还是得回到条件断点,但建议先用 Logpoint 确认变量是否可达、值是否符合预期。
多语言项目里条件表达式写法差异
VS Code 调试器根据 type 字段决定表达式解析引擎,不是所有语言都支持 JS 风格写法:
- Node.js / JavaScript / TypeScript:用标准 JS 语法,
i === 5 || name.includes("test") - Python:用 Python 语法,
i == 5 or "test" in name,但注意None不能用==判断,得写user is not None - Go:用 Go 表达式,
i > 5 && len(items) > 0,不支持函数调用(strings.Contains()会报错) - C++:用 C++ 表达式,
i > 5 && ptr != nullptr,注意指针解引用可能崩溃,调试器不保护
最易被忽略的一点:条件断点的表达式求值发生在目标进程内,不是在 VS Code 主进程中。这意味着你不能用 VS Code 插件 API、不能读取文件系统、也不能依赖编辑器状态——它只是个纯表达式求值器,越简单越可靠。











