rust-analyzer是唯一推荐的rust语言服务器，必须禁用rust-lang.rust插件；否则string标红、补全跳转失效。它依赖path中的cargo/rustc、含cargo.toml的根目录及rust-src组件，缺一即卡在loading…或报no rust project detected。

必须装 rust-analyzer，不是 rust-lang.rust；否则连 String 都标红报 unresolved，补全、跳转、宏展开全部失效。

为什么 rust-analyzer 是唯一选择

VS Code 自身不带 Rust 支持，rust-lang.rust（红黑熊图标）插件早已归档，它走的是已停更的 RLS 协议，不支持 async/await、#[derive] 展开、proc-macro 诊断等现代特性。而 rust-analyzer（蓝色原子图标）是当前 Rust 官方推荐、唯一活跃维护的语言服务器（LSP），所有智能功能都依赖它。

• 装了 rust-lang.rust 后又装 rust-analyzer？两者会冲突，rust-analyzer 常被静默禁用
• 验证方式：打开命令面板（Ctrl+Shift+P），执行 Extensions: Show Enabled Extensions，只留 rust-analyzer 启用状态
• 状态栏右下角出现 rust-analyzer 进度条 ≠ 就绪；需在输出面板（Ctrl+Shift+U）中看到 project model loaded 才算真正加载成功

rustc 和 cargo 找不到？问题几乎全出在 PATH 和启动方式

rust-analyzer 不自带编译器，它完全依赖系统 PATH 中可调用的 cargo 和 rustc。终端能跑不代表 VS Code 能用。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 先在终端运行 cargo --version 和 rustc --version，两个都必须输出版本号（如 rustc 1.80.1）
• 再打开 VS Code 集成终端，同样执行这两条命令——若失败，说明 VS Code 没继承 shell 的 PATH
• macOS/Linux：别从桌面图标启动 VS Code，改用终端执行 code .；若必须图形启动，手动在设置中补全 terminal.integrated.env.macos，例如："PATH": "/Users/xxx/.cargo/bin:${env:PATH}"
• Windows：确认 %USERPROFILE%\.cargo\bin 已加入系统环境变量；若用 Scoop 安装 rustup，还要加 %USERPROFILE%\scoop\shims

项目一打开就卡在 “Loading…”？检查这三个硬性条件

rust-analyzer 要正常工作，必须同时满足三项，缺一不可：

• VS Code 启动时能调用 cargo 和 rustc（见上一条）
• 打开的是含 Cargo.toml 的**项目根目录**，不是子文件夹，也不是单个 .rs 文件
• 项目中已安装 rust-src 组件：rustup component add rust-src；否则跳转到 std::vec::Vec 会失败，报 Failed to load stdlib
• 若仍卡住，按 Ctrl+Shift+P → 输入 Rust Analyzer: Reload Workspace 手动触发，并紧盯输出面板日志

配置项别乱堆，默认够用，但这几个必须设

全局设置易跨项目干扰，尤其多人协作或混合 edition 时。直接在项目根目录建 .vscode/settings.json：

{
  "rust-analyzer.cargo.loadOutDirsFromCheck": true,
  "rust-analyzer.procMacro.enable": true,
  "rust-analyzer.checkOnSave.command": "check"
}

• "rust-analyzer.cargo.loadOutDirsFromCheck": true：让插件通过 cargo check 推导 target/ 路径，避免因权限或路径异常导致构建信息缺失
• "rust-analyzer.procMacro.enable": true：开启宏展开（如 #[derive(Serialize)]、sqlx::query!），但别开除非真用到——开了容易拖慢启动、内存暴涨
• "rust-analyzer.checkOnSave.command": "check"：保存时只做轻量检查；想用 clippy，手动运行 cargo clippy 或交给 CI

误删过 target/？别指望自动重建——rust-analyzer 依赖其中的 rmeta 文件生成语义索引。删了就执行 Rust Analyzer: Reload Workspace，然后耐心等它重新跑完 cargo check。