如何在 VSCode 中排查 Node 环境下事件循环引起的性能瓶颈-VSCode-PHP中文网

node.js 应用应使用 perf_hooks 实时捕获事件循环延迟，通过 performanceobserver 监听 'loop' 类型条目，延迟超50ms时用 console.warn 警告，并在生产环境按1%采样；配合 --inspect 在 chrome devtools 中录制性能火焰图，聚焦 self time 高的函数；优先排查 require 和 fs.readfilesync 等同步操作，对百mb级json解析等cpu密集任务才使用 worker_threads。

如何在 vscode 中排查 node 环境下事件循环引起的性能瓶颈

用 `performance` API 实时捕获事件循环延迟

Node.js 自带的 perf_hooks 是最轻量、最可靠的检测手段，不需要额外依赖或启动参数。它能直接告诉你“事件循环卡了多久”，而不是靠猜。

在应用入口（比如 app.js 或 server.js）顶部加入：

const { PerformanceObserver, performance } = require('perf_hooks');
const obs = new PerformanceObserver((items) => {
  const entry = items.getEntries()[0];
  if (entry.duration > 50) {
    console.warn(`[EVENT LOOP BLOCKED] ${entry.duration.toFixed(2)}ms`);
  }
});
obs.observe({ entryTypes: ['loop'] });

注意：entryTypes: ['loop'] 只在 Node 14.17+ 和 16.13+ 支持；低于此版本请改用 setImmediate + process.hrtime() 手动打点。

延迟超过 50ms 就该警觉——这已超出 HTTP 请求处理的安全窗口
日志要打在 console.warn 而非 console.log，避免被其他日志淹没
别只在开发环境启用——生产环境也应保留（但建议采样率控制在 1%）

用 `--inspect` 配合 Chrome DevTools 定位阻塞函数

VSCode 调试器本身不提供火焰图，但通过 --inspect 把 Node 进程暴露给 Chrome DevTools，就能拿到真实调用栈和耗时分布。

修改 .vscode/launch.json，关键点是加 --inspect-brk 和去掉 runtimeArgs 里可能存在的 --require 干扰：

{
  "type": "node",
  "request": "launch",
  "name": "Profile Event Loop",
  "program": "${workspaceFolder}/app.js",
  "runtimeArgs": ["--inspect-brk"],
  "console": "integratedTerminal"
}

启动后，复制底部状态栏的 ws://... 地址，在 Chrome 访问 chrome://inspect → 点击 inspect → 切到 Performance 标签页 → 点击录制（●），操作几秒后停止。