之前在小组中的一个分享,在这里记录下~
问题:使用launch.json 启动调试失败
问题.png 没能出现调试面板。 调试面板.pnglaunch.json文件如下:
// .vscode/launch.json
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch Egg",
"type": "node",
"request": "launch",
"cwd": "${workspaceRoot}",
"runtimeExecutable": "npm",
"windows": { "runtimeExecutable": "npm.cmd" },
"runtimeArgs": [ "run", "debug"],
"console": "integratedTerminal",
"protocol": "auto",
"restart": true,
"port": 9229,
"autoAttachChildProcesses": true
}
]
}
"script": {
"debug": "era-cloud debug --env local",
}
了解一下 Visual Studio Code Node Debug & launch.json 配置
知识点1:VsCode debug :
VsCode代码编辑器为Node.js运行时提供了内置的调试支持。vs code nodejs-debugging
NodeJS 给我们提供了 Debugger 模块,内建客户端,通过 TCP 将命令行的输入传送到内建模块以达到调试的目的。
在VSCode中有三种方式调试方式:
1、 在内置的终端中使用 auto attach的方式
2、 直接使用debug 面板
3、 使用launch.json配置文件调试: 常用, 配置项全,适合复杂项目。
知识点2: Launch.json配置
launch.json存放在.vscode文件夹下。全部的设置项 https://github.com/microsoft/vscode-js-debug/blob/main/OPTIONS.md
核心是 runtimeExecutable 使用的命令,以及 runtimeArgs 参数,这里不需要 --inspect 了(IDE内部会处理)
-
必选字段
type:调试器类型。这里是 node(内置的调试器),如果装了 Go 和 PHP 的扩展后对应的 type 分别为 go 和 php request:请求的类型,目前只支持 launch 和 attach。launch 就是以 debug 模式启动调试;attach 就是附加到已经启动的进程开启 debug 模式并调试 name:下拉菜单显示的名字
request 字段,有两个值可以选择:launch 和 attach , 它表示VS Code中核心的两种调试模式。
launch 指的是直接由编辑器启动(直接 fork 一个进程);而 attach 表示服务已经启动,我们是 attach 到原来那个进程中,比如上面的 Chrome 调试。然后打上断点,执行就行了。
-
可选字段
program:可执行文件或者调试器要运行的文件 (launch) runtimeArgs:要传递给调试程序的参数 (launch) env:环境变量 (launch) cwd:当前执行目录 (launch) address:ip 地址 (launch & attach) port:端口号 (launch & attach) skipFiles:想要忽略的文件,数组类型 (launch & attach), 比如想绕过对node_modules中文件的调试 //"${workspaceRoot}/node_modules/**/*.js", processId:进程 PID (attach) runtimeVersion: 使用nvm 时 指定版本 eg: 10.19.0 restart:设置为 true,修改代码保存后会自动重启调试 runtimeExecutable:用什么命令执行 app.js,可以为 nodemon,默认是 node console:当点击停止按钮或者修改代码保存后自动重启调试,而 nodemon 是仍然在运行的,通过设置为 console 为 integratedTerminal 可以解决这个问题。
-
目录变量
${workspaceRoot}:当前打开工程的路径 ${file}:当前打开文件的路径 ${fileBasename}:当前打开文件的名字,包含后缀名 ${fileDirname}:当前打开文件所在的文件夹的路径 ${fileExtname}:当前打开文件的后缀名 ${cwd}:当前执行目录
知识点3:Node.js 调试技巧
1、expression :表达式为true时 调试
2、Hit count: 命中次数
知识点4: inspector 调试的一点原理
1、通过给 node 增加 --inspect 参数会开启调试模式
,这个模式下,还会开放一个默认的 9229 端口,允许其他 IDE 接入。
这个模式下,会输出下面的信息:
Debugger listening on ws://127.0.0.1:9229/d598ab05-88e8-433f-b641-bf2766da97f5
For help, see: https://nodejs.org/en/docs/inspector
ws://127.0.0.1:9229/d598ab05-88e8-433f-b641-bf2766da97f5 是暴露的调试链接,里面包含了协议、host、端口和一个唯一的 uuid。这是一个标准 v8 调试协议。
2、但是 仅仅开启调试还是不够的,调试器还没有接收到足够的信息,或者说没有一个展现调试的地方。node 还提供了另一个会卡住的调试命令。--inspect-brk 会停在代码的第一行,等待下一步的指示: image.png3、可以通过命令执行下一步等调试操作, 也可以通过支持 v8调试协议的 UI。
有许多种方法可以作为 UI,而最简单的就是我们电脑上一般都会有的 Chrome 浏览器。
Chrome 自带了一个调试页 chrome://inspect/ ,打开后,如果是在本机,会直接列出可调式的端口和文件地址(如果在远程,也可以配置 ip)。
点击inspect 就可以调试了。 4、在 Chrome UI 打开的时候,控制台会输出一句话。 image.png
这的意识是表明这个调试协议已经连上了 node 开启的调试端口;所以整个调试分为两个部分:
“开启 node 调试端口” + “符合 v8调试协议的调试器 attach 到调试端口”
5、除了使用Chrome调试,也可以使用VSCode, vscode集成了调试的 UI,本质和最基本的一样,开启调试端口,连接调试端口。只是 VSCode 本身是个编辑器,可以直接在其之上打断点,集成度更高;使用方式 就是配置一个上面提到的 launch.json(等价于启动命令)。
总结
: 所有的调试的原理都是一样的,藉由 Node.js 原生的打开调试端口的能力,不同的 IDE 才能连接到该端口,进而做出更加强大的能力。
比如 VSCode 不仅仅能做传统的调试,也能增加配置,在执行调试前后增加钩子,执行自己的命令,这都是扩展能力的体现。
由上面的基础知识, 可以看到 上面JSON的意思是node --inspect-brk=DEBUG_PORT run debug
即执行 'era-cloud debug --env local', debug方式调试启动已过时; era-cloud命令中 可以使用run 命令 image.png解决办法:
更换debug 调试方式为 inspector方式: era-cloud run --env local --port 7070
参考文档:
各种VSCode 调试demo
写 Node.js 代码,从学会调试开始
hi~ 点赞没
网友评论