安装对应语言扩展并配置launch.json文件即可实现VS Code调试;若无扩展,可手动通过命令行运行脚本;要支持断点等高级功能需开发符合DAP的调试适配器。

为一门新语言配置 VS Code 调试器,核心是通过 launch.json 文件定义调试启动方式,并借助语言对应的调试适配器(Debug Adapter)或运行时支持。如果该语言已有成熟扩展,通常只需安装即可;若无现成支持,需手动配置执行命令和调试参数。
确认语言是否已有官方或社区扩展
大多数主流语言(如 Python、JavaScript、Go、Rust 等)都有官方或高质量的 VS Code 扩展,这些扩展通常已内置调试支持。
- 打开 VS Code 扩展市场(Ctrl+Shift+X),搜索目标语言名称
- 安装评分高、维护活跃的扩展(例如:Python 对应 ms-python.python)
- 安装后重启编辑器,通常会自动识别脚本文件并允许设置断点
创建 launch.json 配置文件
在项目根目录下创建 .vscode/launch.json 文件,用于定义调试行为。
- 点击“运行和调试”侧边栏中的“创建一个 launch.json 文件”
- 选择对应环境(如 Node.js、Python 等),或选“Others”进行自定义
- 基本结构如下:
为不支持的语言手动配置(以解释型语言为例)
若语言暂无调试扩展,但可通过命令行运行(如 Ruby、Lua、自定义脚本语言),可使用 command 方式调用解释器。
- 将 type 设为 shell 或 process,配合终端执行
- 示例:调试一个用 mylang 解释器运行的脚本
注意:这种方式不支持断点和变量检查,仅能输出日志或交互式查看。
实现完整调试功能需开发 Debug Adapter
要支持断点、单步执行、变量查看等高级功能,必须实现符合 Debug Adapter Protocol (DAP) 的调试适配器。
- 使用 DAP 官方库(如 dap-mode for Python, vscode-debugadapter for JS)开发适配器服务
- 在 package.json 中注册调试贡献点
- 打包为 VS Code 扩展发布
此过程适合语言开发者或深度工具链构建者,普通用户一般依赖已有生态。
基本上就这些。多数情况下,安装扩展 + 配置 launch.json 就能满足日常调试需求。对于冷门或自制语言,先通过命令行运行验证基础流程,再考虑是否投入开发完整调试器。










