quokka 默认不内联显示 console.log() 输出，因其仅对表达式求值并标注，而 console.log() 是副作用调用、返回 undefined；其输出实际出现在 vscode 底部 output 面板 → quokka，而非终端。
Quokka 为什么看不到 console.log 输出
Quokka 默认不内联显示 console.log() 的结果，这是设计使然，不是 bug。它只对表达式求值并实时标注，而 console.log() 是副作用调用，返回 undefined，所以行尾什么也不显示。
- 想看到值：把变量或表达式单独成行，比如
user.name、arr.filter(x => x > 0) - 想强制内联输出：改用
return，例如return { status: 'ok', data: result }; - 更灵活：在任意位置加
/**?*/，如fetchUser() /**?*/，Quokka 会在此处求值并浮层显示 -
console.log()实际仍会输出——去 VSCode 底部的 Output 面板 → Quokka 查看，不是终端
Console Ninja 怎么捕获浏览器 console 输出
Console Ninja 不需要手动注入代码或修改项目配置，但它依赖目标环境已启用远程调试协议。对浏览器来说，必须用 Chrome 或 Edge 启动时带 --remote-debugging-port=9222 参数，否则插件连不上 DevTools 后端。
- Vite/Next.js 等现代框架默认支持，但需确保启动命令未禁用
devtools（例如vite --host可用，vite --mode preview则可能断开） - 如果右下角 Console Ninja 图标是灰色，说明未连接成功；点击图标可查看当前连接状态和错误提示
- 它捕获的是运行时真实
console.*调用，包括console.group()展开结构、console.table()格式化表格，全部原样映射到编辑器内 - 注意：它不捕获 Node.js 进程的
console，那是另一个通道，需配合 Quokka 或直接看 Output 面板中的 “Node” 日志
Log Viewer 的 tail -f 为什么卡住不动
Log Viewer 的 Tail -f this file 功能本质是调用系统 tail 命令，但它不支持通过 Remote-SSH 直接监听远端文件。如果你在 SSH 连接中右键选择该功能，它会尝试在本地执行 tail，路径却指向远端挂载点（如 /home/user/logs/app.log），导致找不到文件或权限拒绝。
- 正确做法：先在 Remote-SSH 中打开日志文件，再右键 → Open with Log Viewer（不是
Tail -f） - 然后点击 Log Viewer 工具栏上的 Follow 按钮（图标是向下箭头），它会走 VSCode 的文件监听机制，而非系统
tail - 如果日志写入非常频繁（如每毫秒一条），建议在
settings.json中设"logViewer.maxLines": 10000，避免渲染阻塞 - 确认日志文件权限：VSCode 插件以用户身份运行，不能读取
root写的/var/log/*.log，除非你用sudo chown $USER:$USER /path/to/log
如何让 Logpoints 和 Console Ninja 日志对齐时间线
Logpoints 输出到调试控制台，Console Ninja 输出到编辑器内嵌面板，两者时间戳来源不同：前者来自 V8 引擎的 Date.now()，后者来自浏览器 DevTools 协议的事件时间戳，误差通常在几毫秒内，但无法严格同步。
- 不要指望它们按毫秒级顺序排列；关注逻辑先后而非绝对时间
- 若需强关联，可在 Logpoint 表达式里显式打标记，例如
`[LOGPOINT] user ${user.id} loaded`，再在 Console Ninja 面板 Ctrl+F 搜索该标记 - Console Ninja 支持点击日志行跳转源码，Logpoints 也支持；但跨工具跳转不互通，得手动比对行号
- 真正统一的时间线只能靠结构化日志：在代码里用
logger.info('user_loaded', { trace_id: 'xxx', timestamp: Date.now() })，再用 LogLens Pro 插件聚合
