首先实现自定义调试适配器，它作为VSCode前端与目标语言调试后端的桥梁，基于Debug Adapter Protocol（DAP）处理初始化、断点设置和程序控制；通过yo code生成调试扩展模板，配置package.json中的debuggers贡献点，指定调试类型和适配器启动方式；在debugAdapter.ts中继承LoggingDebugSession类，重写initializeRequest、launchRequest和setBreakPointsRequest等方法，响应DAP请求并发送事件；适配器可内联运行或作为独立进程启动，推荐使用vscode-debugadapter库简化JSON-RPC通信；最后在launch.json中配置对应调试类型，启用trace日志进行测试验证。
要在 VSCode 中实现自定义调试器扩展，核心是开发一个“自定义调试适配器”（Debug Adapter），它作为 VSCode 调试前端与目标调试后端之间的桥梁。VSCode 本身不直接理解如何调试某种语言或运行时，而是通过调试协议（Debug Protocol）与调试适配器通信，由适配器负责与实际的调试引擎交互。
1. 理解 VSCode 调试架构
VSCode 的调试功能基于三层结构：
- 前端（UI）：VSCode 编辑器中的断点、变量查看、调用栈等界面元素。
- 调试协议（Debug Protocol）：基于 JSON-RPC 的通信协议，前后端通过 stdin/stdout 交换请求和响应。
- 调试适配器（Debug Adapter）：独立进程，解释调试请求，并与具体语言的调试工具（如解释器、虚拟机）交互。
你的任务就是实现这个调试适配器，使其能响应 VSCode 发来的初始化、设置断点、继续运行等指令。
2. 创建调试扩展的基本结构
使用 yo code 脚手架生成调试扩展模板：
yo code选择“New Code Extension” → “Debug Adapter” 类型。这会生成包含以下关键部分的项目：
- package.json：声明调试贡献点，如调试类型、启动方式、适配器可执行文件位置。
- src/extension.ts：VSCode 插件主入口，启动调试适配器并管理会话。
- src/debugAdapter.ts：调试适配器逻辑，处理来自 VSCode 的请求。
- out/**：编译后的代码。
在 package.json 中，关键字段如下：
"contributes": { "debuggers": [{ "type": "mylang", "label": "My Language Debugger", "languages": ["mylang"], "configurationAttributes": { ... }, "initialConfigurations": [ ... ], "adapterExecutableCommand": "mylangDebugAdapter" }] }其中 type: "mylang" 是你在 launch.json 中使用的调试类型。
3. 实现调试适配器
调试适配器需遵循 Debug Adapter Protocol (DAP)。你可以手动解析 JSON-RPC 消息，但推荐使用官方提供的 vscode-debugadapter 库。
安装依赖：
npm install --save vscode-debugadapter在 debugAdapter.ts 中，继承 LoggingDebugSession：
import { LoggingDebugSession } from 'vscode-debugadapter'; import { DebugProtocol } from 'vscode-debugprotocol'; class MyDebugAdapter extends LoggingDebugSession { protected initializeRequest( response: DebugProtocol.InitializeResponse, args: DebugProtocol.InitializeRequestArguments ): void { response.body = response.body || {}; response.body.supportsConfigurationDoneRequest = true; this.sendResponse(response); } protected launchRequest( response: DebugProtocol.LaunchResponse, args: ILaunchRequestArguments ): void { // 启动目标程序，建立通信 this.sendResponse(response); // 示例：发送“调试已启动”事件 this.sendEvent(new InitializedEvent()); } protected setBreakPointsRequest( response: DebugProtocol.SetBreakpointsResponse, args: DebugProtocol.SetBreakpointsArguments ): void { // 解析源文件，设置断点，返回实际命中位置 const breakpoints = args.breakpoints.map(src => ({ verified: true, line: src.line })); response.body = { breakpoints }; this.sendResponse(response); } } // 启动适配器 DebugSession.start(MyDebugAdapter);你需要根据你的语言运行时实现诸如解析脚本、注入断点、单步控制、变量求值等逻辑。
4. 启动方式：内联 vs 外部进程
调试适配器可以以内联方式（TypeScript 直接运行）或独立进程（Node.js 脚本、其他语言编译程序）运行。
- 内联模式：适合简单场景，在 extension.ts 中直接创建适配器实例并通过管道连接。
- 外部进程：更常见，适配器作为一个独立 Node.js 程序（如 debugAdapter.js），通过 debugServer 或 adapterExecutableCommand 启动。
例如，在 extension.ts 中指定适配器路径：
const server = require.run([__dirname, "debugAdapter.js"]); const session = new DebugAdapterServer(server);5. 测试与调试
按 F5 启动扩展开发主机，在子 VSCode 实例中创建 .vscode/launch.json，使用你定义的调试类型：
{ "type": "mylang", "request": "launch", "name": "Launch My Program", "program": "${workspaceFolder}/test.mylang" }设置断点，启动调试，观察适配器输出和通信日志。启用 trace 可输出详细 DAP 消息：
"trace": true基本上就这些。实现一个完整调试器需要处理变量作用域、调用栈、异常中断、表达式求值等，但起点就是让适配器正确响应初始化和断点请求。一旦通信建立，逐步扩展功能即可。
