用Vscode写过Node这类项目的小伙伴们都知道, 如果我们想要排查问题的时候大部分都是通过console.log
进行打印来看问题在哪, 如果涉及到的问题比较复杂的时候会选择通过Vscode中debug来调试尝试解决, 可如果是Nest项目的话, 除了配置launch.json的话, 在调试的时候可能会提示 找不到任务“tsc: build - tsconfig.json”。
package.json
首先在package.json的script脚本中配置命令来优化, 这样不需要每次都在终端敲那么长的命令
{
"scripts": {
"start":"nest start",
"dev:debug": "pnpm run start:debug",
"start:debug": "nest start --debug --watch",
}
}
我们通过运行pnpm run dev:debug
就可以在运行在使用nest命令运行项目的时候添加`—debug``参数来进行调试, 但是这个时候我们只是把项目运行起来了, 在VSCode中打断点的时候并不会断住, Debug面板中也没有运行
Attach 调试
- 打开命令面板(command+shift+p),搜索
Toggle Auto Attach
,选中后回车启用
- 选择总是: 这样只要在终端通过nodejs运行任务的时候都会启动一个ws的调试端口
这个时候通过, 终端会出现下面这行,接着访问http://localhost:9229/json, 就可以看到VSCode运行的每个调试用的wb(wbsocket), VScode调试本质上就是通过双端通信的方式进行调试
Debugger listening on ws://127.0.0.1:9229/8e908307-94a7-4513-a525-82953b2c02c7
For help, see: https://nodejs.org/en/docs/inspector
launch.json
现在我们可以通过本配置lunch.json的调试方式为attach
来进行调试刚刚VScode提供的调试进程
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
// 调试方式改为附加
"request": "attach",
"name": "Attach Nest",
"skipFiles": [
"<node_internals>/**"
],
// 启动调试器之前运行任务进行编译TS项目
"preLaunchTask": "npm: dev:debug",
"outFiles": [
"${workspaceFolder}/dist/**/*.js"
]
}
]
}
注意preLaunchTask, 上面我们说到在启动调试的时候会提示会提示 **找不到任务“xxx tsconfig.json”。**我们需要在调试先通过tsc 编译
tasks.json
在VS Code中通过 tasks 配置文件,可以定义一组任务以便在编辑器中执行。
{
"version": "2.0.0",
"tasks": [
{
"type": "typescript",
"tsconfig": "tsconfig.json",
"problemMatcher": [
"$tsc"
],
"group": "build",
"label": "tsc: build",
"options": {
"emit": "true",
"pretty": "true",
}
},
{
"type": "npm",
"script": "dev:debug",
"problemMatcher": [],
"label": "npm: dev:debug",
"detail": "pnpm run start:debug",
"dependsOn": [
"tsc: build"
]
}
]
}
下面解释下上面配置的两个任务
tsc: build
: TypeScript 编译任务,它使用tsconfig.json
文件中的配置来编译 TypeScript 代码。任务的类型为typescript
,所以它会使用tsc
命令来执行编译。在编译期间,如果有任何错误,则会使用$tsc
问题匹配器来识别错误信息。npm: dev:debug
: 运行 NestJS 应用程序的调试任务。它的类型是npm
,可以使用 NPM、Yarn 或 PNPM 来运行脚本。该任务执行dev:debug
脚本,该脚本由 NestJS 应用程序开发人员定义,并在package.json
文件中指定。该任务的依赖关系是tsc: build
,这意味着在运行npm: dev:debug
任务之前,需要先执行tsc: build
任务来编译 TypeScript 代码。
至此我们就可以通过在VScode面板点击调试按钮, 运行npm: dev:debug
任务使用编译后的 JavaScript 代码来启动 NestJS 应用程序的调试版本。通过这种方式,可以在 VS Code 中轻松地执行构建和调试操作,并使用一个简单的命令来启动整个过程。