rust-analyzer是VS Code中唯一必需的核心插件，提供类型检查、跳转定义等关键功能；Windows用户须额外安装Microsoft C++ Build Tools；settings.json需配置clippy检查、proc-macro启用等选项。
rust-analyzer 是唯一需要装的核心插件
VS Code 里所谓“Rust 插件”不是指某个叫 rust 的单一扩展，而是以 rust-analyzer 为语言服务器（LSP）的整套支持体系。它替代了已停更的 RLS，是当前 Rust 社区事实标准。其他插件如 Rust Syntax、Better TOML 都只是辅助，不装也能写代码，但没 rust-analyzer 就等于没有类型检查、跳转定义、实时错误提示——写 Rust 几乎寸步难行。
安装方式很简单：打开 VS Code → Ctrl+Shift+X → 搜索 rust-analyzer → 点击“Install”。注意别装错成旧版 Rust（作者是 rust-lang），那个图标是红底白 R，已多年未更新，不兼容现代 Rust 版本。
Windows 用户必须额外装 Microsoft C++ Build Tools
很多 Windows 用户装完 rust-analyzer 后发现“一切正常”，但一运行 cargo run 就报 linker 错误，比如：
error: linking with `link.exe` failed: exit code: 1181
这不是插件问题，而是 Rust 编译器找不到 Windows 链接器。原因是你没装 MSVC 工具链。即使你只写纯 Rust 代码（不调 C 库），Windows 默认仍依赖 link.exe。
- 去微软官网下载
Build Tools for Visual Studio 2022（不是完整 VS IDE） - 安装时勾选 “Desktop development with C++” 工作负载
- 确保子项中包含
MSVC v143和Windows SDK - 装完重启终端，再在 PowerShell 或 CMD 中执行
cl.exe验证是否可识别
settings.json 里这几个配置不能少
rust-analyzer 默认行为偏保守，不改配置容易漏掉关键提示或格式化失效。直接编辑 VS Code 设置（Ctrl+, → 右上角打开 settings.json）加这几行：
{
"rust-analyzer.check.command": "clippy",
"rust-analyzer.cargo.loadOutDirsFromCheck": true,
"rust-analyzer.procMacro.enable": true,
"editor.formatOnSave": true,
"rust-analyzer.rustfmt.overrideCommand": ["rustfmt"]
}
说明：
-
"rust-analyzer.check.command": "clippy"把默认检查从cargo check升级为clippy，能捕获更多潜在 bug -
"rust-analyzer.cargo.loadOutDirsFromCheck"解决 target 目录路径识别失败导致的“找不到模块”假报错 -
"rust-analyzer.procMacro.enable"必开，否则 derive 宏（如#[derive(Debug)]）无法展开，类型推导全崩
插件装完却没反应？先看 cargo 是否就位
rust-analyzer 不是独立运行的，它底层靠 cargo 提供项目结构和依赖信息。如果你在非 Cargo 项目根目录打开文件（比如直接打开单个 .rs 文件），插件会静默失效，连语法高亮都可能不工作。
验证方法：
- 终端进项目根目录（含
Cargo.toml） - 执行
cargo metadata --format-version=1 > /dev/null（Linux/macOS）或cargo metadata --format-version=1 > nul（Windows） - 如果报错“Unable to update registry”，说明 cargo 没联网或镜像配置异常；如果报错“Cargo.toml not found”，说明路径不对
插件启动日志藏在 VS Code 输出面板（Ctrl+Shift+U）→ 选 “rust-analyzer”，里面第一行通常是 rustc 和 cargo 路径。路径为空或指向错误位置，基本就是工具链没装好或环境变量没生效。
