Logpoint 是 VSCode 中不中断执行、仅输出表达式求值结果到 Debug Console 的日志断点；普通 breakpoint 会暂停程序需手动继续，而 Logpoint 适用于高频、异步及性能敏感场景，依赖调试器支持与 sourcemaps 正确配置。
Logpoints 是什么，和普通 breakpoint 有什么区别
Logpoints 是 VSCode 调试器提供的一种「只打日志、不中断执行」的断点类型。它不会暂停代码运行，而是在命中时把指定表达式求值后输出到 Debug Console 或终端——这特别适合你只想观察某个变量在循环里怎么变、又不想被反复打断的情况。
普通 breakpoint 会 halt 线程，Logpoint 实际上是底层调试协议（如 DAP）下发的一个带 logMessage 的断点指令，背后由运行时（比如 Node.js 的 inspector 协议或 Chrome DevTools Protocol）支持。
- Logpoint 只在支持该能力的调试器中生效：Node.js、Chrome、Edge、Python（需 Python extension ≥2023.8）、Go（Delve ≥1.21）等主流环境都已支持
- 它不能替代 step-in/step-over，但能大幅减少「暂停 → 看变量 → resume → 再暂停」的机械操作
- 如果你在 launch.json 里没启用
console: "integratedTerminal"或没开 Debug Console，日志可能直接消失不见
如何在 VSCode 里设置一个有效的 Logpoint
VSCode 中设置 Logpoint 最快的方式是：在编辑器左侧 gutter 点击断点位置，然后长按鼠标左键（或右键）选择「Add Log Point…」；也可以用快捷键 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac），输入「Debug: Toggle Log Point」触发。
设置时填入的内容会被当作模板字符串处理，支持以下语法：
-
{variableName}：自动求值并打印 -
{variableName, JSON}：以 JSON 格式展开打印（对对象/数组很实用） -
{Date.now(), number}：强制转成数字格式（支持number/string/hex） - 普通文本如
"count = {i}, time = {Date.now()}"会被原样拼接
注意这些常见坑：
- 表达式必须是当前作用域可访问的，
{this.state}在箭头函数里会报ReferenceError - 不支持语句，只能是表达式：
{console.log('hi')}❌（会报错），{'hi'}✅ - 如果用了未定义变量，Logpoint 会静默失败（不报错也不输出），建议先在 Watch 面板确认变量名拼写
为什么 Logpoint 有时不输出，或输出内容为空
最常遇到的不是「设不了」，而是「设了但看不到」。原因通常有三个层面：
-
调试会话未真正启动：Logpoint 依赖调试器连接。如果只是按了
F5但 launch.json 配置错误（比如program路径不存在），VSCode 可能显示「Started debugging」但实际没 attach 上，Logpoint 就不会触发 -
源码映射失效：在 TypeScript 或 Webpack 构建项目中，如果
sourceMaps关闭或路径不对，VSCode 找不到原始 .ts 行，Logpoint 就挂载失败（gutter 上显示空心圆圈，悬停提示「unbound」） - 运行时限制：Node.js 旧版本（<14.18）对 inspector 的 logMessage 支持不稳定；某些嵌入式 JS 引擎（如 QuickJS）根本不支持 Logpoint
验证是否生效的小技巧：
- 在 Logpoint 行加个普通 breakpoint，跑一次看是否能停住 → 确认断点位置可达
- 在同一行加
console.log('test')对比输出 → 排除逻辑跳过问题 - 打开 Debug Console，输入
debugger;触发一次暂停，再手动执行console.log({yourVar})→ 确认变量确实存在且可读
Logpoint 和 console.log 的实际取舍建议
Logpoint 不是 console.log 的升级版，而是不同场景下的工具：
- 临时观测、不想改源码、怕提交日志 → 用 Logpoint（关掉调试器就自动消失）
- 需要长期保留、做条件过滤（如
if (x > 100) console.log(x)）、或要输出到文件 → 还得写console.log或用 winston/pino - 多线程/异步密集场景（如 WebSocket 心跳、动画帧），Logpoint 因为不阻塞，比
console.log更轻量；但高频 Logpoint（如每毫秒一次）仍可能拖慢 V8 的优化编译
一个小提醒：Logpoint 的表达式是在目标运行时环境中求值的，所以 {process.env.NODE_ENV} 能取到，但 {vscode.workspace.name} 这种 VSCode API 是拿不到的——它不在那个上下文里。
