原文发表于作者的个人博客：http://morning.work/page/maintainable-nodejs/debuging-nodejs-with-chrome-devtools.html 转载请注明出处

在 Node.js v6.3 之前的版本，调试程序使用的是旧的 V8 Debugger Protocol，可以通过 node --debug app.js 来进行。而为了能在图形界面下进行可视化断点调试，需要借助 VSCode、WebStorm 之类的编辑器和插件，或者安装额外的工具，比如 node-inspector 。

对于大多数的前端开发者来讲，对 Chrome 浏览器自带的 DevTools 并不陌生。新版本的 Node.js 开始支持新的 Chrome DevTools Protocol，通过 node --inspect app.js 即可启动新版本的调试协议，借助 Chrome DevTools 即可达到与以往调试 Web 页面一样的使用体验。

一些编辑器也开始支持新的 Node.js 调试协议，或者通过安装 Chrome 插件 NIM 来支持。但是如果你电脑上已安装了 Node.js 6.3+ 和 Chrome 55+，那么不再需要任何额外的工具即可轻轻松松调试你的 Node.js 程序了。

断点调试

首先让我们新建一个程序文件 app.js 以便体验新的调试方式：

const http = require('http');
const server = http.createServer(function (req, res) {
  res.writeHead(200, { 'content-type': 'text/html' });
  res.end('<h1>It works!</h1>');
});
server.listen(3000, function () {
  console.log('Listening on http://localhost:3000');
});

然后执行以下命令启动程序并进入调试模式：

node --inspect app.js

可以看到控制台打印出以下信息：

Debugger listening on ws://127.0.0.1:9229/1bde07a4-2afa-44b1-a3bc-45aa9977ff67
For help see https://nodejs.org/en/docs/inspector
Listening on http://localhost:3000

此时，打开 Chrome 浏览器（需要 Chrome 55 或更高版本），在地址栏中输入 chrome://inspect 并按回车，会打开如下界面：

点击界面上的 Open dedicated DevTools for Node 链接即可打开调试窗口：

在该窗口中点击 Sources 标签，并在左侧边栏的 file:// 下找到我们编写的源码文件 app.js 即可看到其源码。如果要进行断点调试，只需要在源码的行号上点一下即可：

在窗口的右侧边栏，可以看到 Watch（监视） 、 Call Stack（调用堆栈） 、 Scope（作用域） 等信息。你也可以直接在源码窗口修改里面的代码，并按 ⌘ + S（Windows 系统是 Ctrl + S）保存即可立即生效。

关于在 Chrome DevTools 调试 JavaScript 更详细的介绍可以参考这篇文章：《使用 Chrome DevTools 调试 JavaScript》

性能分析

通过调试界面的 Profiler 标签可以分析哪些 Node.js 程序的 CPU 占用比较高：

我们可以借助 wrk 命令进行简单的 HTTP 接口测试。首先点击界面中的 Start 按钮开始记录 CPU 占用信息，然后在命令行窗口执行以下命令（启动 5 个线程，100 个并发连接，持续 1 分钟）：

wrk -c 100 -t 5 -d 1m http://localhost:3000/

等待 1 分钟，命令执行完毕后，在 DevTools 界面点击 Stop 按钮，即可看到如下的结果：

另外还可以通过 Memory 标签来进行内存占用相关的分析。

关于 Chrome DevTools 的进行 JavaScript 性能分析的更详细使用方法可以参考这篇文章：《Chrome DevTools 之 Profiles，深度性能优化必备》

调试 TypeScript 程序

如果你的程序是使用 TypeScript 编写的，可以借助 ts-node 来启动调试模式：

ts-node --inspect app.ts

或者：

node --inspect --require ts-node/register app.ts

调试正在运行的 Node.js 进程

如果程序启动的时候没有加上 --inspect 选项，为了让它进入调试模式，可以给该进程发送 SIGUSR1 信号来调试（92801 是被调试 Node.js 进程的 PID，根据实际情况替换）：

kill -s SIGUSR1 92801

可以看到该进程控制台会打印出以下提示：

Debugger listening on ws://127.0.0.1:9229/cc35d4da-c8ae-42e3-943a-8ac81d5c067a
For help see https://nodejs.org/en/docs/inspector

此时按照上文的方法使用 Chrome DevTools 调试即可。

参考资料

• Debugging Node.js Apps
• Debugging Node.js with Chrome DevTools
• Debugging Node.js with Google Chrome
• Node.js Command Line Options
• 使用 Chrome DevTools 调试 JavaScript
• Chrome DevTools 之 Profiles，深度性能优化必备
• How is node --inspect different from using Node Inspector?
• Chrome DevTools Protocol Viewer
• Debugging over the V8 Inspector API