VSCode for Rust：配置RLS与调试

需安装rustup及RLS组件、VSCode的rust-lang.rust扩展、配置launch.json启用lldb调试；但推荐切换至rust-analyzer：卸载RLS组件，安装matklad.rust-analyzer插件并自动管理服务器。

如果您希望在 Visual Studio Code 中为 Rust 项目启用智能代码补全、跳转定义和实时错误检查，并能直接启动调试会话，则需要正确配置 Rust Language Server（RLS）及相关调试工具。以下是完成该配置的具体步骤：

本文运行环境：MacBook Pro，macOS Sequoia。

一、安装 Rust 工具链与 RLS

RLS 依赖于 Rust 官方工具链，必须通过 rustup 安装并显式添加 rls 组件。仅安装 rustc 和 cargo 不足以支持语言服务器功能。

1、打开终端，执行 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh 安装 rustup。

2、运行 source $HOME/.cargo/env 激活当前 shell 的环境变量。

3、执行 rustup component add rls rust-analysis rust-src 安装 RLS 及其依赖组件。

二、安装 VSCode 扩展

VSCode 需通过扩展与 RLS 建立通信，官方推荐使用 rust-lang.rust 插件，它内置对 RLS 的适配逻辑，并提供语法高亮与格式化支持。

1、在 VSCode 中按下 Cmd+Shift+X 打开扩展面板。

2、搜索 rust-lang.rust 并点击“安装”按钮。

3、安装完成后重启 VSCode，确保扩展已激活。

三、配置 launch.json 启用调试

VSCode 默认不包含 Rust 调试器，需手动配置 C++ 调试器（cppvsdbg 或 lldb）并指定可执行文件路径。Rust 编译产物为本地二进制，调试器需指向 target/debug/ 下的对应文件。

1、在项目根目录下创建 .vscode/launch.json 文件（若不存在）。

零一万物开放平台

零一万物大模型开放平台

48

查看详情

2、写入以下内容（以 macOS + lldb 为例）：

{ "version": "0.2.0", "configurations": [ { "type": "lldb", "request": "launch", "name": "Debug Rust", "cargo": { "args": ["build"], "filter": { "name": "main", "kind": "bin" } }, "program": "${workspaceFolder}/target/debug/main" } ] }

四、切换至 rust-analyzer 替代方案

RLS 已被 rust-analyzer 官方标记为废弃，当前主流做法是卸载 RLS 并改用 rust-analyzer，后者提供更稳定的类型推导与响应速度，且无需额外安装 rust-src 组件。

1、执行 rustup component remove rls rust-analysis rust-src 清理旧组件。

2、在 VSCode 扩展市场中安装 matklad.rust-analyzer 插件。

3、确保 rust-analyzer.serverPath 设置为空，插件将自动下载并管理语言服务器二进制。

五、验证调试器连接状态

调试前需确认生成的二进制具备调试符号，否则断点无法命中。Cargo 默认在 debug 模式下启用 debuginfo，但若修改过 profile 设置，可能意外关闭该选项。

1、检查项目根目录下的 Cargo.toml 是否存在 [profile.dev] debug = true 行。

2、在终端中运行 cargo build 重新构建项目。

3、在 main.rs 中设置断点后，按 Cmd+Shift+D 切换到运行视图，点击绿色三角形启动调试。

以上就是VSCode for Rust：配置RLS与调试的详细内容，更多请关注php中文网其它相关文章！