rust analyzer 扩展未正确安装或配置会导致 vscode 中 rust 项目代码补全、跳转定义和类型提示失效；需依次完成扩展安装、工具链验证、cargo 配置启用、settings.json 高级设置及 proc-macro 支持开启。
如果您在 Visual Studio Code 中开发 Rust 项目，但代码补全、跳转定义或类型提示功能未生效，则很可能是 Rust Analyzer 扩展未正确安装或配置。以下是完成安装与高级配置的具体步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装 Rust Analyzer 扩展
Rust Analyzer 是 VSCode 官方推荐的 Rust 语言服务器，需通过扩展市场手动安装，而非依赖 rustup 工具链自动部署。
1、启动 VSCode，点击左侧活动栏中的扩展图标（四个方块组成的图标）。
2、在扩展搜索框中输入 rust analyzer，确保选择官方发布的 rust-lang.rust-analyzer 扩展（发布者为 rust-lang）。
3、点击“安装”按钮，等待安装完成，然后点击“重新加载”使扩展生效。
二、验证 Rust 工具链完整性
Rust Analyzer 依赖本地已安装的 rustc 和 cargo，若工具链缺失或版本过旧，会导致语言服务器无法启动。
1、打开终端，执行 rustc --version，确认输出包含有效版本号（如 rustc 1.80.1）。
2、执行 cargo --version，验证 cargo 可用性。
3、若任一命令报错，需通过 rustup install stable 和 rustup default stable 补全工具链。
三、启用 Rust Analyzer 的 Cargo 配置
Rust Analyzer 默认仅分析 workspace 根目录下的 Cargo.toml，若项目含多个 crate 或自定义构建脚本，需显式指定 Cargo 配置路径。
1、在 VSCode 中按下 Cmd + Shift + P（macOS）调出命令面板。
2、输入并选择 Rust Analyzer: Reload Workspace，强制刷新依赖解析上下文。
3、若仍无法识别子 crate，在项目根目录创建 rust-project.json 文件，并写入对应 crate 路径数组。
四、配置 rust-analyzer 设置项
VSCode 的 settings.json 中可覆盖默认行为，提升大型项目的响应速度与准确性。
1、按下 Cmd + , 打开设置界面，点击右上角“打开设置（JSON）”图标。
2、在 settings.json 的 "rust-analyzer" 对象内添加以下键值对：
3、设置 "cargo.loadOutDirsFromCheck": true，启用基于 cargo check 的输出目录推导。
4、设置 "checkOnSave.command": "check"，避免保存时触发完整编译。
五、启用 proc-macro 支持
若项目使用 derive 宏（如 serde_derive、thiserror），默认情况下 Rust Analyzer 不展开 proc-macro，需手动开启支持。
1、确保系统已安装 just 或 cargo-expand 工具（可通过 cargo install cargo-expand 安装）。
2、在 settings.json 中添加配置项："rust-analyzer.procMacro.enable": true。
3、重启 VSCode 窗口或执行 Rust Analyzer: Restart Server 命令以激活宏展开能力。
