在 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 )保存即可立即生效。
性能分析
通过调试界面的 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 标签来进行内存占用相关的分析。
调试 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 调试即可。