首先需创建符合DAP的调试适配器,通过Yeoman生成模板项目,实现debugAdapter.js逻辑并注册到package.json,最后在launch.json中配置对应调试类型完成集成。

在 VSCode 中创建自定义调试器,实际上是开发一个调试扩展(Debug Adapter),让 VSCode 能够与特定语言或运行环境的调试工具对接。这个过程不是简单配置就能完成的,而是需要编写代码来实现调试协议通信。下面是具体步骤和要点。
理解 VSCode 调试机制
VSCode 本身不直接执行调试逻辑,它通过 Debug Adapter Protocol (DAP) 与外部的“调试适配器”通信。你需要做的是:
- 实现一个符合 DAP 的调试适配器(Debug Adapter)
- 注册该适配器到 VSCode 扩展中
- 配置 launch.json 支持你的调试类型
创建 VSCode 扩展项目
使用 Yeoman 生成器快速搭建调试扩展模板:
npm install -g yo generator-codeyo code
选择 “New Debug Adapter” 模板,按提示填写名称、调试语言等信息。这会生成包含基本结构的项目,包括:
- package.json:声明调试贡献点
- debugAdapter.js:调试适配器主逻辑
- extension.js:VSCode 插件入口,启动适配器
实现调试适配器逻辑
调试适配器本质是一个进程,负责与 VSCode 和目标程序通信。你可以用 Node.js、Python、C# 等语言实现,只要能处理 DAP 消息。
核心任务包括:
- 监听来自 VSCode 的 DAP 请求(如 launch、attach、next、stepIn)
- 将请求转换为目标环境的实际操作(比如调用 GDB、LLDB 或解释器调试接口)
- 返回响应并发送事件(如断点命中、变量更新)
可以使用官方提供的 vscode-debugadapter 库简化开发:
主要特点为模板驱动,前台页面和数据库数据在模板中以标签方式调用和显示。星期三企业建站系统产品全部代码都为星期三网络原创,有着完全的知识产权。我们会已我们的努力使星期三企业建站系统变的更好!系统功能1\网站信息设置2\菜单管理3\系统页面4\幻灯片管理5\友情链接6\商品分类 7\商品管理 8\资讯分类 9\资讯管理 10\自定义页面分类 11\自定义页面 12\留言管理 13\下载管理 14\选择
它提供基类 DebugSession,你只需继承并重写对应方法即可。
配置 package.json 注册调试器
确保 package.json 中有正确的调试贡献:
"contributes": {"debuggers": [{
"type": "my-debugger",
"label": "My Custom Debugger",
"languages": ["mylang"],
"configurationAttributes": { ... },
"initialConfigurations": [ ... ]
}]
}
其中 type 是你在 launch.json 中引用的调试类型名。
测试与调试你的调试器
按 F5 启动扩展开发主机,在新窗口中打开目标文件,添加 launch 配置:
{"type": "my-debugger",
"request": "launch",
"name": "Launch Program",
"program": "${workspaceFolder}/test.my"
}
触发调试后,可在开发者控制台和输出面板查看通信日志。
基本上就这些。虽然流程复杂,但官方模板和 DAP 规范文档能大幅降低门槛。关键是理解“VSCode → Debug Adapter → 目标程序”的三层结构。









