Logpoint没输出日志，主因是调试环境未正确配置或Debug Console未打开；需确认使用支持Logpoint的调试器（如pwa-node、chrome）、图标为橙色菱形、sourceMap启用，并手动打开Debug Console（Ctrl+Shift+Y）。
Logpoint 为什么没输出日志？
Logpoint 不输出，大概率不是代码问题，而是调试环境没配对或控制台没打开。VSCode 的 Logpoint 依赖底层调试器支持（如 Node.js inspector、Chrome DevTools Protocol），且必须在 Debug Console 可见时才能看到日志——如果它被最小化或关闭，日志就直接“消失”了。
- 确认你正在用支持 Logpoint 的调试配置：比如
launch.json中的type是"pwa-node"、"chrome"、"python"（需 debugpy ≥1.6）等，而非老旧的"node"（旧版 node-debugger 已弃用） - 启动调试前，手动打开 Debug Console：快捷键
Ctrl+Shift+Y（Win/Linux）或Cmd+Shift+Y（Mac） - 检查是否误设成了普通断点：Logpoint 图标是菱形
?，不是红色圆点；右键断点后选的是「Edit Log Point」，不是「Edit Breakpoint」 - 变量插值失败时会静默显示
undefined，比如写{user.profile.name}但user是null，不会报错，但日志里只看到空值
Logpoint 插值语法和常见写法错误
Logpoint 的日志模板本质是字符串插值，{} 里必须是合法表达式，且作用域受限于断点所在行——它不是运行时 eval，不能跨函数访问局部变量，也不能调用带副作用的函数。
- ✅ 正确：
Batch {batch_idx}: loss = {loss:.4f}、{new Date().toISOString()} | status: {status}、User {user?.id ?? "anonymous"} - ❌ 错误：
{console.log(x)}（语句）、{x = x + 1}（赋值）、{if (x) {...}}（控制流）、{undefinedVar}（未声明变量，插值为空但不提示） - 浮点数格式化仅在部分调试器生效（如 Python、Node.js 支持
{x:.3f}），Chrome DevTools 不支持，会原样输出{x:.3f} - 中文文本可直接写，如
【请求开始】{url}，耗时{Date.now() - start}ms，只要{}内表达式合法即可
Logpoint 和条件断点混用要注意什么
你可以同时设置 Logpoint 和条件表达式，但两者的触发逻辑不同：Logpoint 总是“执行即输出”，而条件表达式控制的是“是否触发该 Logpoint”。两者叠加时，条件判断先于日志求值，所以表达式里不能依赖 Logpoint 插值中才计算的值。
- 正确组合：
Expression填loss > 0.5，Log Message填High loss alert: {loss.toFixed(3)}—— 先判断，再安全插值 - 错误假设：
Expression写{loss} > 0.5——{loss}是 Logpoint 插值语法，不是 JavaScript 表达式，调试器会直接忽略该条件 - 别把 Logpoint 当作“轻量级 console.log”滥用：高频循环里每轮都打日志，Debug Console 刷屏会卡顿，甚至拖慢程序；此时优先考虑
Hit Count或前置过滤（如batch_idx % 10 === 0） - Logpoint 不会阻塞异步流程，但大量日志仍可能让 V8/Python 解析器在后台多做一次字符串拼接，对毫秒级性能敏感场景要留心
Python / Node.js / Chrome 调试器的 Logpoint 差异
Logpoint 行为看似一致，实则受调试器实现影响较大。同一段日志模板，在不同环境下的表现可能完全不同。
- Python（debugpy）：
{x}支持完整对象repr()，{x.attr}若x是 None 会抛异常并中断 Logpoint 输出（表现为某次日志突然消失）；推荐加空值保护：{getattr(x, "attr", "N/A")} - Node.js（inspector）：
{process.memoryUsage().heapUsed}这类实时计算可用，但避免频繁调用 GC 相关 API，否则影响性能 - Chrome（PWA）：不支持格式化语法（如
{x:.2f}），{new Date()}返回的是对象，不是字符串，建议显式调用{new Date().toISOString()} - 所有环境都不支持跨作用域访问：比如在
for循环外定义的let debugMode = true，若 Logpoint 设在循环内且debugMode未被闭包捕获，插值结果就是undefined
Logpoint 看似简单，真正难的是理解它背后调试协议的边界——它不是代码注入，也不是运行时 eval，而是一次受控的、作用域受限的表达式求值。变量是否存在、能否链式取值、格式化是否生效，全取决于当前调试器的能力与上下文快照，而不是你的直觉。
