WSL环境下VSCode调试Rust代码报错：无codelldb.cargo任务类型

问题背景 #

在Windows系统的VSCode中调试WSL内的Rust代码时调试失败，但代码可正常运行并输出预期结果。已为WSL安装codeLLDB、rust-analyzer扩展，环境版本：WSL 1、VSCode 1.72.2、Windows 10。

报错信息 #

Error: there is no registered task type 'codelldb.cargo'. Did you miss installing an extension that provides a corresponding task provider?
Error: there is no registered task type 'codelldb.cargo'. Did you miss installing an extension that provides a corresponding task provider?

当前launch.json配置 #

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "lldb",
            "request": "launch",
            "name": "Debug executable 'foo'",
            "cargo": {
                "args": [
                    "build",
                    "--bin=foo",
                    "--package=foo"
                ],
                "filter": {
                    "name": "foo",
                    "kind": "bin"
                }
            },
            "args": [],
            "cwd": "${workspaceFolder}"
        },
    ]
}

解决办法 #

1. 确认codeLLDB扩展安装位置 #

确保codeLLDB扩展安装在WSL环境而非Windows本地：

• 打开VSCode扩展面板，找到codeLLDB
• 查看右侧是否显示"Installed in WSL: [你的发行版名称]"，如果未安装，点击"Install in WSL"按钮完成安装

2. 修改launch.json，手动指定可执行文件路径 #

放弃codeLLDB的cargo自动构建逻辑，改用手动指定编译后的可执行文件路径：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "lldb",
            "request": "launch",
            "name": "Debug executable 'foo'",
            "program": "${workspaceFolder}/target/debug/foo",
            "args": [],
            "cwd": "${workspaceFolder}"
        }
    ]
}

• 若调试release版本，将路径改为${workspaceFolder}/target/release/foo
• 修改前需先执行cargo build（或cargo build --release）生成可执行文件

3. 更新VSCode及扩展到最新版本 #

你的VSCode 1.72.2版本较旧，可能存在WSL与codeLLDB的兼容性问题：

• 更新VSCode到最新稳定版
• 在扩展面板中更新rust-analyzer和codeLLDB扩展，重启VSCode后重试调试

4. 升级到WSL 2（可选） #

WSL 1对Linux工具的兼容性弱于WSL 2，调试器在WSL 2环境下更稳定：

• 打开PowerShell，执行wsl --set-version <你的发行版名称> 2（例如wsl --set-version Ubuntu-20.04 2）
• 等待版本转换完成后重启WSL，再尝试调试

内容的提问来源于stack exchange，提问作者rakd