需安装 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 文件（若不存在）。
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 切换到运行视图，点击绿色三角形启动调试。
