使用Chrome DevTools调试NodeJS：--inspect与--inspect-brk最佳实践

针对你遇到的RuntimeError调试场景，结合--inspect和--inspect-brk的特性，最佳实践如下：

• 优先使用node --inspect-brk启动调试
  这个命令会在Node.js进程启动后立即暂停在代码的第一行（模块加载阶段），彻底解决调试器附着不及时或代码执行过快的问题，给你充足时间打开Chrome DevTools并连接调试会话。启动命令直接用：node --inspect-brk app.js，之后打开Chrome输入chrome://inspect，找到目标进程点击inspect即可进入调试界面，此时代码还未执行到业务逻辑断点，不会错过调试时机。

• 配置package.json调试脚本提升效率
  避免每次手动输入长命令，在项目的package.json中添加调试脚本：

  "scripts": {
    "debug": "node --inspect-brk app.js"
  }
  

  之后只需运行npm run debug就能快速启动调试会话。

• 调试会话内的精准断点设置
  既然已在源码根处添加断点，进入DevTools后可直接等待代码执行到该断点；如果RuntimeError是异步操作导致的，开启DevTools的Pause on exceptions功能（界面上带闪电标的停止按钮），勾选后会在抛出异常时自动暂停，不管是否有try/catch包裹，能直接定位错误发生位置。

• 临时替代方案（仅作补充）
  若偶尔需要使用--inspect，可在代码最开头添加一行同步延迟代码，给调试器留足附着时间：

  // 仅调试阶段使用，上线前务必移除
  setTimeout(() => {}, 5000); // 延迟5秒执行后续逻辑
  

  但此方法可靠性远不如--inspect-brk，仅作为临时应急方案。

内容的提问来源于stack exchange，提问作者Henry Jones