如何使用Node.js进行多样化的断点调试技巧?
- 内容介绍
- 文章标签
- 相关推荐
本文共计1260个文字,预计阅读时间需要6分钟。
Node.js 开启 debug 模式通过传递参数 +--inspect 或 +--inspect-brk,调试方法分为 IDE 和 Chrome DevTools 两种。下面具体讲解这两种方式如何调试 Node.js 程序;
Part 1:VS Code 调试:
1. launch.json 配置:
首先,在 VS Code 中打开 Node.js 项目,然后进入 `.vscode` 文件夹,创建一个名为 `launch.json` 的文件。在 `launch.json` 文件中,添加以下配置:
json{ version: 0.2.0, configurations: [ { type: node, request: launch, name: Launch Program, program: ${workspaceFolder}/index.js, skipFiles: [/**], inspect: true } ]}
2. 配置详解:
- `type: node`:指定调试器类型为 Node.js。- `request: launch`:表示这是一个启动配置。- `name: Launch Program`:调试会话的名称。- `program: ${workspaceFolder}/index.js`:要调试的 Node.js 程序路径。- `skipFiles: [/**]`:跳过 Node.js 内部文件,避免干扰调试。- `inspect: true`:开启 debug 模式。
3. 启动调试:
在 VS Code 中,按下 `F5` 或点击 Run and Debug 按钮,即可启动调试。此时,程序将在指定的 `index.js` 文件中暂停,等待调试器连接。
nodejs开启debug模式通过传递参数 --inspect 或 --inspect-brk ,调试方法分为IDE和chrome devtools两种,下面就具体讲解这两种方式如何调试node程序;
part1:VS Code调试:
一、launch.json 配置
配置详解看另一篇:VSCode launch.json配置详解
浅析VSCode launch.json中的各种替换变量的意思 ${workspaceFolder} ${file} ${fileBasename} ${fileDirname}等
1 nodejs调试:
1.1 点击添加配置文件
我们看到 .vscode/launch.json的configurations.program属性为 "${workspaceFolder}/express-app.js" ,表示调试的入口文件,其中 workspaceFolder
是vscode资源管理器的根目录
1.2 启动调试
点击绿色箭头,启动调试
2. 调试npm scripts
在实际项目中,命令基本上都是放到了npm scritps中 ps: 注意调试npm scripts时参数 --inspect 必须指定端口
2.1 添加npm scripts
{ ... "scripts": { ... "debug": "node --inspect-brk=6666 index.js" }, ... }
6666是任意指定的调试端口号。
2.2 修改vscode调试配置
打开 .vscode/launch.json 删除 program 属性 增加以下3个配置项, runtimeExecutable,runtimeArgs,port 。
{ ... "configurations": [ { ... "runtimeExecutable": "npm", //默认是node,这里改成npm "runtimeArgs": [ "run-script",//别名 run "debug"//对应上npm scripts上的debug ], "port": 6666 //调试端口 } ] }
2.3 启动调试
启动调试方法同上
3. 调试非node命令
3.1 node_modules/.bin
npm run 会自动添加 node_module/.bin 到当前命令所用的PATH变量中,例如:
{ ... "scripts": { "build": "webpack" }, ... }
运行 npm run build 实际上是调用 node_modules/.bin/webpack 而运行 node_modules/.bin/webpack 实际上会根据当前shell环境调用对应脚本,查看可以发现有3个同名不同后缀名的脚本: webpack(标注了可执行程序sh) 、 webpack.cmd 、webpack.ps1 例如在cmd命令行工具下会调用 webpack.cmd 脚本,查看代码可以发现内部实际上是调用命令:
node ./node_modules/webpack/bin/webpack.js
3.2 不能直接加 --inspect-brk
这种情况下,直接加 --inspect-brk=6666 是不行的 以下配置,会自动执行npm run debug,但不会进入断点。
{ ... "scripts": { "debug": "webpack --inspect-brk=6666" }, ... }
3.3 转换成node调用
修改npm scripts:
{ ... "scripts": { "debug": "node --inspect-brk=6666 ./node_modules/webpack/bin/webpack.js" }, ... }
启动成功!
3.4 stopOnEntry
设置 configurations.stopOnEntry=true ,启动调试后,断点可以自动停在第一行代码上
二、attach 附加到node.js
1. Auto Attach 自动附加无需配置,快速开始调试
打开用户设置,修改 "debug.node.autoAttach": "on" ,开启自动附加
vscode集成终端输入 node --inspect-brk index.js
自动进入vscode的debug模式;
2. 设置“附加”配置
跟自动附加相比,可以显式配置各种调试配置选项,示例配置如下:
{ "name": "Attach to Process", "type": "node", "request": "attach", "processId": "${command:PickProcess}" },
启动步骤:
1.命令行以debug模式运行nodejs程序
node --inspect-brk index.js
2.选择并运行附加配置
3. 选择要附加的进程 ,开启调试
part2: Chrome DevTools调试:
Chrome DevTools是nodejs天生支持的调试方式,使用步骤:
1.命令行以debug模式运行nodejs程序
node --inspect-brk index.js
2.打开谷歌浏览器,访问 chrome://inspect/#devices ,可以看到当前浏览器监听的所有 inspect 3.点击下图红框内的超链接,会打开Chrome DevTools面板,就可以使用他的各种功能
vscode远程调试插件:Remote Development
总结
到此这篇关于nodejs各种姿势断点调试的方法的文章就介绍到这了,更多相关nodejs 断点调试内容请搜索易盾网络以前的文章或继续浏览下面的相关文章希望大家以后多多支持易盾网络!
本文共计1260个文字,预计阅读时间需要6分钟。
Node.js 开启 debug 模式通过传递参数 +--inspect 或 +--inspect-brk,调试方法分为 IDE 和 Chrome DevTools 两种。下面具体讲解这两种方式如何调试 Node.js 程序;
Part 1:VS Code 调试:
1. launch.json 配置:
首先,在 VS Code 中打开 Node.js 项目,然后进入 `.vscode` 文件夹,创建一个名为 `launch.json` 的文件。在 `launch.json` 文件中,添加以下配置:
json{ version: 0.2.0, configurations: [ { type: node, request: launch, name: Launch Program, program: ${workspaceFolder}/index.js, skipFiles: [/**], inspect: true } ]}
2. 配置详解:
- `type: node`:指定调试器类型为 Node.js。- `request: launch`:表示这是一个启动配置。- `name: Launch Program`:调试会话的名称。- `program: ${workspaceFolder}/index.js`:要调试的 Node.js 程序路径。- `skipFiles: [/**]`:跳过 Node.js 内部文件,避免干扰调试。- `inspect: true`:开启 debug 模式。
3. 启动调试:
在 VS Code 中,按下 `F5` 或点击 Run and Debug 按钮,即可启动调试。此时,程序将在指定的 `index.js` 文件中暂停,等待调试器连接。
nodejs开启debug模式通过传递参数 --inspect 或 --inspect-brk ,调试方法分为IDE和chrome devtools两种,下面就具体讲解这两种方式如何调试node程序;
part1:VS Code调试:
一、launch.json 配置
配置详解看另一篇:VSCode launch.json配置详解
浅析VSCode launch.json中的各种替换变量的意思 ${workspaceFolder} ${file} ${fileBasename} ${fileDirname}等
1 nodejs调试:
1.1 点击添加配置文件
我们看到 .vscode/launch.json的configurations.program属性为 "${workspaceFolder}/express-app.js" ,表示调试的入口文件,其中 workspaceFolder
是vscode资源管理器的根目录
1.2 启动调试
点击绿色箭头,启动调试
2. 调试npm scripts
在实际项目中,命令基本上都是放到了npm scritps中 ps: 注意调试npm scripts时参数 --inspect 必须指定端口
2.1 添加npm scripts
{ ... "scripts": { ... "debug": "node --inspect-brk=6666 index.js" }, ... }
6666是任意指定的调试端口号。
2.2 修改vscode调试配置
打开 .vscode/launch.json 删除 program 属性 增加以下3个配置项, runtimeExecutable,runtimeArgs,port 。
{ ... "configurations": [ { ... "runtimeExecutable": "npm", //默认是node,这里改成npm "runtimeArgs": [ "run-script",//别名 run "debug"//对应上npm scripts上的debug ], "port": 6666 //调试端口 } ] }
2.3 启动调试
启动调试方法同上
3. 调试非node命令
3.1 node_modules/.bin
npm run 会自动添加 node_module/.bin 到当前命令所用的PATH变量中,例如:
{ ... "scripts": { "build": "webpack" }, ... }
运行 npm run build 实际上是调用 node_modules/.bin/webpack 而运行 node_modules/.bin/webpack 实际上会根据当前shell环境调用对应脚本,查看可以发现有3个同名不同后缀名的脚本: webpack(标注了可执行程序sh) 、 webpack.cmd 、webpack.ps1 例如在cmd命令行工具下会调用 webpack.cmd 脚本,查看代码可以发现内部实际上是调用命令:
node ./node_modules/webpack/bin/webpack.js
3.2 不能直接加 --inspect-brk
这种情况下,直接加 --inspect-brk=6666 是不行的 以下配置,会自动执行npm run debug,但不会进入断点。
{ ... "scripts": { "debug": "webpack --inspect-brk=6666" }, ... }
3.3 转换成node调用
修改npm scripts:
{ ... "scripts": { "debug": "node --inspect-brk=6666 ./node_modules/webpack/bin/webpack.js" }, ... }
启动成功!
3.4 stopOnEntry
设置 configurations.stopOnEntry=true ,启动调试后,断点可以自动停在第一行代码上
二、attach 附加到node.js
1. Auto Attach 自动附加无需配置,快速开始调试
打开用户设置,修改 "debug.node.autoAttach": "on" ,开启自动附加
vscode集成终端输入 node --inspect-brk index.js
自动进入vscode的debug模式;
2. 设置“附加”配置
跟自动附加相比,可以显式配置各种调试配置选项,示例配置如下:
{ "name": "Attach to Process", "type": "node", "request": "attach", "processId": "${command:PickProcess}" },
启动步骤:
1.命令行以debug模式运行nodejs程序
node --inspect-brk index.js
2.选择并运行附加配置
3. 选择要附加的进程 ,开启调试
part2: Chrome DevTools调试:
Chrome DevTools是nodejs天生支持的调试方式,使用步骤:
1.命令行以debug模式运行nodejs程序
node --inspect-brk index.js
2.打开谷歌浏览器,访问 chrome://inspect/#devices ,可以看到当前浏览器监听的所有 inspect 3.点击下图红框内的超链接,会打开Chrome DevTools面板,就可以使用他的各种功能
vscode远程调试插件:Remote Development
总结
到此这篇关于nodejs各种姿势断点调试的方法的文章就介绍到这了,更多相关nodejs 断点调试内容请搜索易盾网络以前的文章或继续浏览下面的相关文章希望大家以后多多支持易盾网络!

