logpoint 是不暂停执行的“打印式断点”，仅求值输出到 debug console；普通断点会中断程序需手动继续，而 logpoint 适合高频、异步、性能敏感场景，依赖调试器支持且需正确配置 sourcemaps。
Logpoint 是什么，和普通断点有什么本质区别
Logpoint 本质是「带打印语句的断点」，但它不会暂停执行——VSCode 在命中时会把表达式求值结果输出到 Debug Console，然后立刻继续运行。关键在于它不触发 debugger 暂停逻辑，也不依赖 console.log 手动插入和清理。
普通断点（Breakpoint）会让程序停住，你得手动按 F5 继续；而 Logpoint 只输出，适合高频调用路径、异步回调、性能敏感代码里“看一眼就走”的场景。
注意：Logpoint 依赖调试器支持，不是所有运行时都可用。Node.js（v14+）、Python（通过 Python extension + debugpy）、JS/TS 在 Chrome 或 Node 环境下基本都支持；但纯前端浏览器 DevTools 的 Logpoint 功能较弱，VSCode 的 Node/Python 调试体验更稳定。
怎么加 Logpoint：右键菜单 vs 快捷键，以及表达式写法
在 VSCode 编辑器左侧行号区域右键 → 选择 Add Log Point，或把光标放在某行按 Ctrl+Shift+P（Win/Linux）/Cmd+Shift+P（Mac），输入 “Debug: Toggle Log Point”。
输入的表达式会被求值并打印，支持：
- 直接变量名：
user.name - 字符串拼接：
<code>id: ${id}, status: ${status} - 函数调用（需确保无副作用）：
JSON.stringify(data) - 条件过滤（可选）：在 Logpoint 编辑框底部勾选
Condition，填入布尔表达式，比如items.length > 10
⚠️ 容易踩的坑：
- 表达式里不能有赋值操作（如
i++、x = 1），否则 Logpoint 会静默失效或报错 - 异步上下文中的变量（如
await fetch()后面那行）可能因作用域问题取不到，优先用当前行已声明的局部变量 - 不要写超重操作，比如
fs.readFileSync(...)或大数组.map(...).filter(...)，会影响运行时性能
Logpoint 输出在哪看，怎么和普通 console.log 区分
输出默认出现在 VSCode 的 Debug Console 面板（不是 Terminal，也不是 Output 面板）。打开方式：调试启动后，按 Ctrl+Shift+Y（Win/Linux）/Cmd+Shift+Y（Mac），或点击侧边栏的 Run and Debug → 底部切换到 Debug Console。
每条 Logpoint 输出格式类似：
logpoint: src/utils.ts:42 → "user id: 123, role: admin"
和手写的 console.log 的核心区别：
- 不污染源码，调试完删掉 Logpoint 即可，不用搜
console.去清理 - 输出带精确文件+行号前缀，避免日志来源混淆
- 支持条件触发，而
console.log得套if，易留痕 - 在 attach 模式（如调试已运行的 Node 进程）下，Logpoint 仍可用；但
console.log插入后需重启进程才生效
为什么有时候 Logpoint 没输出？常见排查点
Logpoint 不生效，大概率不是功能坏了，而是环境或配置没对上：
- 调试配置里没启用
sourceMaps（TS/webpack/babel 项目必须开），否则 VSCode 找不到原始行号，Logpoint 就挂空挡 - 当前行没有被实际执行（比如被 if 分支跳过、函数未调用、await 后的行还没走到）
- 使用了不支持 Logpoint 的调试器：确认
launch.json中type是node、pwa-node、python等，而不是chrome（旧版 Chrome 调试器不支持 Logpoint） - 文件保存后没触发重新编译（TS/ESBuild/Vite 场景下，改了代码但没 rebuild，Logpoint 加在了旧 sourcemap 上）
最简单的验证方式：在简单 JS 文件里写两行，启动 Node 调试，加个 Logpoint，看 Debug Console 是否立刻出内容。能跑通再往复杂项目里迁。
Logpoint 看似小功能，但真正用熟之后，你会发现自己越来越少地靠打断点 + step over 来“猜”变量状态，尤其在处理 Promise 链、事件循环、第三方库回调时，它比加 console.log 干净，比设断点轻量——只是别忘了检查 sourcemap 和调试器类型。
