企业官网建设流程全解析

• 教程
• 文档

Node.js 从v6.3.0起就原生支持使用 Chrome 开发者工具（Chrome Developer Tools）进行调试，无需安装任何第三方调试器。本文基于 30-seconds-of-code 仓库中的 Node.js 调试速查文章，完整梳理从启动带断点的 Node.js 进程、在 Chrome 中打开about:inspect页面，到借助 DevTools 面板完成断点、单步、调用栈分析与表达式求值的一整套实战流程，帮助你像调试前端代码一样调试后端服务。

说明：本文涉及的调试流程适用于任意 Node.js 应用；该文章在仓库中位于 JavaScript 文章集合（content/collections/js/node.yaml中languageMatcher: javascript、tagMatcher: node），是 JavaScript 文章集合 下 Node.js 主题的一篇入门级速查文档，并可通过/articles/s/nodejs-chrome-debugging跳转（见 redirects.yaml）。

准备工作：安装合适的 Node.js 版本

Chrome 开发者工具对 Node.js 的支持始于v6.3.0（该版本首次内置了基于 Chrome DevTools 协议的调试器）。因此，使用本文的方法前，请确认本机 Node.js 版本不低于6.3.0：

node --version

若输出版本号低于6.3.0，需要先升级 Node.js。推荐使用 Node.js 官方维护的当前活跃 LTS（长期支持）版本——自v6.3.0以来，这一调试能力被完整保留并持续增强，新版本同样适用，且稳定性与性能更佳。

以 --inspect-brk 启动：让进程在首行等待调试器

调试的第一步是启动 Node.js 进程，并让其主动暴露调试端口。核心命令如下：

node --inspect-brk index.js

其中：

• --inspect：以调试模式启动 Node.js 进程，默认在127.0.0.1:9229端口开启 WebSocket 调试会话，进程会正常执行代码；
• --inspect-brk：在--inspect的基础上，在脚本第一行执行前就暂停（break），等待调试器连接后再继续。这是「从零开始调试」最常用的方式，因为应用启动阶段（如模块初始化、环境变量读取、数据库连接）往往正是 bug 的高发区域；
• index.js：替换为你的实际入口文件，例如server.js、app.js等。

启动后终端通常会输出类似以下信息：

Debugger listening on ws://127.0.0.1:9229/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx For help, see: https://nodejs.org/en/docs/inspector

这表示调试会话已经建立，等待 DevTools 客户端连接。

常用调试启动参数速查

需要说明的是，--inspect系列标志针对的是当前被调试的 Node.js 进程本身，它不会改变业务代码的执行逻辑，只会额外开启一个调试通道，因此可以放心用于本地开发环境。

打开 about:inspect 并连接到 Node.js 实例

Node.js 进程已处于调试等待状态后，接下来在 Chrome 浏览器中完成连接：

1. 打开 Chrome，在地址栏输入并回车访问内部页面：about:inspect；
2. 页面中的Remote Target区域会自动列出可调试的目标——此时应能看到你的 Node.js 进程及其命令行信息（如上面的node --inspect-brk index.js）；
3. 点击目标条目下方的Open dedicated DevTools for Node按钮；
4. Chrome 会打开一个独立的开发者工具窗口，该窗口已连接到你的 Node.js 进程。

由于使用了--inspect-brk，此时 DevTools 窗口内的代码会停留在index.js的第一行，等待你执行下一步调试动作。这就是上图中about:inspect页面所展示的「发现目标 → 点击连接」的交互流程。

在 DevTools 中进行断点调试

连接成功后，就可以像调试前端 JavaScript 一样使用完整的调试面板：

• Sources（源代码）面板：查看所有加载的脚本文件，点击行号左侧即可设置/取消断点；支持条件断点（右键断点设置表达式）、日志断点等；
• Step Over / Step Into / Step Out：单步跳过、步入函数、步出函数，逐行追踪执行路径；
• Watch（监视）与 Scope（作用域）：实时查看变量值与当前调用栈的局部变量、闭包变量、全局变量；
• Console（控制台）：在断点处直接执行任意表达式、调用函数或修改变量，用于现场验证假设；
• Call Stack（调用栈）：回溯当前执行位置来自哪个函数调用链，快速定位问题源头；
• Breakpoints 面板：集中管理所有断点，可临时禁用或删除。

一个典型的调试循环是：先在可疑函数处设置断点 → 使用刷新/重放触发代码路径 → 命中断点后结合 Watch 与 Console 检查变量 → 用 Step Into 深入底层调用 → 修正逻辑后继续运行。

结束调试与后续建议

调试完成后，在 DevTools 窗口点击 Resume（继续）或直接关闭窗口即可结束调试会话；Ctrl+C 终止终端中的 Node.js 进程同样会释放调试端口。

几点实用建议：

• 优先使用--inspect-brk而非--inspect：对于需要观察初始化过程的场景，首行暂停能确保调试器「接得住」应用启动阶段的全部执行细节；
• 对进程管理器中的服务：如果 Node.js 应用由 PM2、Docker 等进程管理器启动，可为其额外传递--inspect参数并映射调试端口，实现远程调试；
• 将该文章作为速查入口：本文源于仓库中的 nodejs-chrome-debugging.md，其 front matter 使用tags: [node, debugging]、封面图为bug，适合作为 Node.js 调试主题的快速参考；仓库还提供了 Node.js 文章集合 以便浏览更多服务端相关技巧。

现在，你已经掌握了从命令行启动到 DevTools 断点调试的完整链路，可以把这套方法直接应用到日常的 Node.js 开发与排错中。

• 教程
• 文档