Visual Studio Code Debug Adapter Node.js 项目启动与配置教程

1. 项目的目录结构及介绍

Visual Studio Code Debug Adapter Node.js 项目通常包含以下目录结构：

.
├── adapter
│   ├── __tests__
│   │   └── ...
│   ├── src
│   │   └── ...
│   └── package.json
├── launchers
│   ├── __tests__
│   │   └── ...
│   ├── src
│   │   └── ...
│   └── package.json
├── test
│   └── ...
├── .vscode
│   └── launch.json
├── .github
│   └── ...
├── .gitignore
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
├── package.json
├── README.md
└── ...

• adapter 目录：包含了Debug Adapter的实现代码，以及相关的测试代码。
• launchers 目录：包含了用于启动和调试程序的launchers，以及相关的测试代码。
• test 目录：包含了项目的单元测试和集成测试代码。
• .vscode 目录：包含了Visual Studio Code的工作区配置文件，例如launch.json用于配置调试器。
• .github 目录：包含了GitHub工作流和模板文件。
• .gitignore 文件：定义了哪些文件和目录应该被Git忽略。
• CHANGELOG.md 文件：记录了项目的更新和修改历史。
• CONTRIBUTING.md 文件：提供了贡献指南，告诉贡献者如何向项目贡献代码。
• LICENSE 文件：包含了项目的许可证信息。
• package.json 文件：定义了项目的依赖、脚本和元数据。
• README.md 文件：提供了项目的概述、安装和使用说明。

2. 项目的启动文件介绍

项目的启动通常是通过package.json中的脚本来实现的。以下是package.json中的示例脚本：

"scripts": {
  "start": "node adapter/src/debugAdapter.js",
  "test": "jest"
}

这里定义了两个脚本：

• "start"：用于启动Debug Adapter。它将运行adapter/src/debugAdapter.js文件。
• "test"：用于运行测试，这里使用了jest作为测试框架。

要启动项目，可以在项目根目录下运行以下命令：

npm start

这将启动Debug Adapter，并监听来自Visual Studio Code的调试请求。

3. 项目的配置文件介绍

项目的配置文件主要是.vscode/launch.json。这个文件用于配置Visual Studio Code的调试器。以下是一个示例配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Node.js Launch",
      "type": "node",
      "request": "launch",
      "program": "${workspaceFolder}/adapter/src/debugAdapter.js",
      "stopOnEntry": false,
      "args": [],
      "cwd": "${workspaceFolder}",
      "console": "integratedTerminal"
    }
  ]
}

这个配置定义了一个名为Node.js Launch的调试配置，它指定了以下选项：

• "type"：调试的类型，这里是Node.js。
• "request"：调试的请求类型，这里是启动一个新的调试会话。
• "program"：要调试的程序的路径。
• "stopOnEntry"：是否在程序入口处停止。
• "args"：传递给程序的命令行参数。
• "cwd"：程序的工作目录。
• "console"：调试过程中使用的控制台类型。

使用这个配置，你可以通过Visual Studio Code的调试界面启动和调试项目。