Logpoint 能真正不暂停程序，前提是被正确识别为橙色菱形日志点而非红色实心断点；图标、添加方式、快捷键（Alt/Option+Click）、调试会话启用、sourceMap 配置及输出位置均影响其正常工作。
Logpoint 能真正不暂停程序，但前提是它被正确识别为日志点而非普通断点——90% 的“卡住”问题都源于误打了红色实心圆（普通断点），而不是橙色菱形（Logpoint）。
怎么确认你加的是 Logpoint 而不是普通断点
VSCode 行号左侧的图标决定行为：实心红点 = 暂停执行；橙色菱形 + 号 = 只打印、不暂停。右键菜单里选 Add Log Point… 才生成后者；左键单击默认是前者。快捷键更可靠：Alt + Click（Windows/Linux）或 Option + Click（macOS）直接把红点转成橙色菱形，绕过 UI 权限判断。
常见错误现象：
- Debugger paused 弹窗反复出现 → 实际是普通断点没删干净
- 接口响应变慢、动画卡顿 → 高频行（如
render()或循环体）误设了普通断点 - Debug Console 无输出 → 图标看着像 Logpoint，但其实是未验证断点（unverified breakpoint），常因
launch.json中program路径错或 sourceMap 未启用
Logpoint 表达式能写什么、不能写什么
Logpoint 的表达式在调试器上下文中求值，不是 JS 运行时执行，所以它安全但受限：
- ✅ 支持：
user.id、`status: ${res.status}`、JSON.stringify(data)、arr.length - ❌ 不支持：
getData()（函数调用会被忽略）、let x = 1（声明语句报错）、this.state（若当前作用域无this则 undefined） - ⚠️ 注意：模板字符串中插值只对已存在变量生效；
${notDeclared}会输出undefined，不会报错但可能误导
为什么 Logpoint 有时根本不输出日志
Logpoint 是调试器能力，不是编辑器功能——它必须依赖正在运行的调试会话才能激活：
- 必须先启动调试（
Ctrl+Shift+D→ 点绿色三角形），不能靠Ctrl+F5（运行而不调试） - Node.js 项目需确保
launch.json中type为"node"，且program指向真实入口（如"${workspaceFolder}/src/index.ts"） - TypeScript 项目必须开启 sourceMap：编译选项含
"sourceMap": true，且launch.json中建议显式配"sourceMaps": true - Chrome 调试需启动时带
--remote-debugging-port=9222，否则 Logpoint 降级为普通断点
高频场景下的性能和兼容性提醒
Logpoint 在循环或事件回调里很实用，但仍有隐性成本：
- 每次命中都要序列化变量并跨进程传给 VSCode，10 万次循环里打一个
Logpoint可能拖慢数秒 - Python（debugpy ≥ v1.7）、Go（dlv ≥ v1.8）才稳定支持；旧版会静默 fallback 成普通断点
- Node.js 使用
node --inspect启动才启用完整协议；用ts-node直接跑可能不识别 Logpoint
最易被忽略的一点：Logpoint 输出位置是 Debug Console，不是 Terminal 或浏览器控制台——切错面板就以为没生效。
