本文深入解析 Node.js 深度调试技术，涵盖 V8 Inspect 命令行工具、Chrome DevTools 图形化调试以及 VS Code 集成调试。详细讲解启动参数、断点设置、日志点、TypeScript Source Map 支持、子进程追踪及远程服务器调试配置，帮助开发者高效排查复杂应用问题。
Node.js 调试概述
Node.js 项目演进中调用关系日趋复杂，调试工具变得至关重要。
Node v6.3+ 集成 V8 Inspect 调试器，支持 Chrome DevTools 图形化调试及性能分析，VS Code 和 Webstorm 等编辑器亦支持 Node.js 调试。
V8 Inspect 命令行调试
Node Inspect
启动 Node.js 应用需传入 --inspect 标志，可指定自定义端口如 --inspect=9222 以接受开发者工具连接。
一段简单的代码
function log() {
let a = 1;
console.log(a);
a = 2;
console.log(a);
}
log();使用 node --inspect 启动
直接执行代码不会中断，无法使用 Chrome DevTools 调试；应使用 --inspect-brk 参数在代码第一行终端处中断后再调试。
Chrome DevTools 图形化调试
Chrome DevTools
开启 Node 调试后，打开 Chrome 访问 chrome://inspect，在 Devices 中找到 Node.js 程序并点击 inspect 打开调试面板。
在调试工具窗口设置断点，运行程序进行调试。
运行中程序动态调试
运行中程序调试
对于 Express Web 服务等正在运行的 Node.js 程序，不能停止服务后以 --inspect 运行调试。
首先获取服务的进程 Id。
向脚本进程发送 SIGUSR1 信号，即可建立调试连接。
kill -SIGUSR1 34943 复制代码
在 Windows 平台下，可以使用下面的命令
node -e 'process._debugProcess(30464)'
需要注意的是：这种调试任然会中断服务进程的执行。
VS Code 集成调试配置
VS Code 调试
快速调试
对于简单的应用程序，可以打开文件，按 F5 并选择调试类型为 Node，即可进行调试
使用配置调试
对于大多数的调试场景，更推荐使用配置文件，因为它可以配置并保存调试设置的信息，方便我们下次快速使用。在 VC Code 中，调试配置通常存储在 .vscode 文件夹下的 launch.json 文件中 。可以点击左侧栏目中的调试图标，快速创建 launch.json 文件
VS Code 会自动下面类似的 launch.json 调试配置文件，其中 program 代表我们需要调试的文件路径，workspaceFolder 为当前工作区的路径，通常是项目的根目录
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "启动程序",
"skipFiles": ["<node_internals>/**"],
"program": "${workspaceFolder}/index.js"
}
]
}设置断点，即可启动调试，并在左侧的树视图中看到变量对应的值以及堆栈信息
launch.json
launch.json 中有许多不同的属性，支持不同的调试器和调试场景，下面的属性在每个启动配置中是必须的
- name - 当前调试配置项的名称，可读性要好，区分每个调试配置项
- type - 用于此启动配置的调试器的类型。每个已安装的调试扩展都引入一种类型：例如node，php，go 等。
- request - 当前调试项的类型，目前支持 launch 和 attach 两种类型。launch 适合调试未启动的程序，attach 则适合调试已经运行的程序。
一些其他比较有用的选项：
- program - 启动调试器时要运行的可执行程序或文件
- args - 传递给程序进行调试的参数
- env - 调试时的环境变量
- envFile - 包含环境变量键值对的文件
- stopOnEntry - 程序启动时立即中断
- port - 连接到正在运行的调试器的端口
- runtimeExecutable - 启用调试的可执行 Runtime，默认是 Node
日志点 (Logpoints) 使用
日志点 - Logpoints
VS Code 提供了好用的调试小工具 - 日志点，日志点是断点的一种变体，它不 "中断 "进入调试器，而是将一条消息记录到控制台，日志点对于在调试不能暂停或停止的生产服务器时注入日志特别有用。
NPM 脚本调试
NPM 脚本调试
除了使用 node 启动 Node.js 项目之外，VS Code 还支持自定义启动程序 runtime，借助这个能力，可以直接使用 NPM 启动调试。如下面，使用 npm run debug 启动调试
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "启动程序",
"skipFiles": ["<node_internals>/**"],
"program": "${workspaceFolder}/index.js"
}
]
}launch.json
{
"type": "node",
"request": "launch",
"name": "NPM 启动",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "debug"],
"port": 9229
}TypeScript Source Map 调试
TypeScript 调试
VS Code 内置的 Node.js 的调试器支持 JavaScript Source Map，可以结合 Source Map 调试转译前的代码，如 TypeScript，压缩混淆的 JavaScript 代码等都可以利用 Source Map 的支持调试源码。
我准备了一个简单的 TS Server Demo，可以直接 Clone 源码本地测试。下面是项目中的 src/index.ts 文件，创建了一个 HTTP Server
import * as http from "http";
let reqCount = 1;
http
.createServer((req, res) => {
const message = `Request Count: ${reqCount}`;
res.writeHead(200, { "Content-Type": "text/html" });
res.end(`<html><div>${message}</div></html>`);
console.log("handled request: " + reqCount++);
})
.listen(3000);
console.log("server running on port 3000");创建 tsconfig.json 配置，配置编译生成 Source Map
{
"compilerOptions": {
"outDir": "./dist",
"sourceMap": true
},
"include": ["src/**/*"]
}使用 tsc 编译一下，生成 JS 代码：dist/index.js，创建调试配置，入口文件为 dist/index.js
{
"type": "node",
"request": "launch",
"name": "Launch Program",
"program": "${workspaceFolder}/dist/index.js",
"skipFiles": ["<node_internals>/**"]
}然后打断点，启动调试，浏览器访问 http://localhost:3000，即可看到调试进入了 TS 文件
远程服务器调试
远程调试
当我们需要在真实的服务器等远程运行环境调试 Node.js 时，我们可以利用上面提到的方式，在服务器上开启 Node.js 调试功能，并在本地连接上远程的调试端口进行调试。
VS Code 默认支持远程调试，我们需要 launch.json 配置文件中指定远程服务的 IP 地址以及端口，如下所示：
{
"type": "node",
"request": "attach",
"name": "远程调试",
"address": "IP 地址",
"port": "9229"
}VS Code 会自动加载远程的文件，展示为只读代码供调试使用。
如果想要在调试的过程中编辑源代码，或者更好的调试体验，可以在远程文件夹和本地项目之间设置一个映射。VS Code 提供了 localRoot 和 remoteRoot 属性来映射本地 VS Code 项目和（远程）Node.js 文件夹：
{
"type": "node",
"request": "attach",
"name": "远程调试",
"address": "IP 地址",
"port": "9229",
"localRoot": "${workspaceFolder}/src",
"remoteRoot": "/var/user/"
}在建立映射关系后，即可在本地项目进行断点调试，远程的断点信息会同步到本地项目，使用起来十分方便。
子进程调试与自动附加
子进程调试
与普通进程调试原理一致，子进程调试时也需要传入 --inspect 参数，这一点需要特别注意，否则无法启动子进程调试。
如下通过子进程启动 Server 的例子：
// fork.js 文件
const { spawn } = require("child_process");
const sp = spawn("node", ["./fork_server.js"]);
console.log("父进程 PID", sp.pid);
sp.stdout.on("data", (data) => {
console.log(`stdout: ${data}`);
});
sp.stderr.on("data", (data) => {
console.error(`stderr: ${data}`);
});如果直接使用 node --inspect 启动主进程的话，会发现只显示了主进程的调试端口，这就是因为我们在程序中启动子进程时没有传递 --inspect 选项导致的。
这里我们在启动进程时添加上 --inspect 参数，同时注意要指定一个默认 9229 端口之外的端口号，避免调试端口冲突
- const sp = spawn("node", ["./fork_server.js"]);
+ const sp = spawn("node", ["--inspect=9230", "./fork_server.js"]);再次启动，就能看到两个调试信息输出了
当然，怎么能少得了强大的 VS Code 呢。VS Code 的 Node 调试器提供了一种机制，可以追踪所有子进程，并在调试模式下，自动链接进程。可以通过 autoAttachChildProcesses 属性开启此机制：
{
"type": "node",
"request": "launch",
"name": "启动程序",
"program": "${workspaceFolder}/fork.js",
"autoAttachChildProcesses": true
}启动后，即可对父进程，或子进程进行断点调试，效果如下
结语
到此这篇关于Node.js 深度调试方法解析的文章就介绍到这了,更多相关Node.js 深度调方法内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站！