VS Code 运行 Rust 的核心是 rust-analyzer 正确识别项目结构、工具链和依赖，需确保 Cargo.toml 存在、rust-toolchain.toml 生效、工作区路径正确，并安装 rust-src 组件。
VS Code 要跑 Rust，核心不是装插件，而是让 rust-analyzer 正确识别你的项目结构、工具链和依赖。它不依赖 cargo 的全局配置，但极度依赖 Cargo.toml 是否存在、rust-toolchain.toml 是否生效、以及 VS Code 工作区是否打开在正确路径下。
安装 Rust 工具链：别只用 rustup default
很多问题源于工具链没对齐。rust-analyzer 默认使用 rustc 输出的 sysroot 路径，而该路径由当前激活的 toolchain 决定：
- 运行
rustup install stable（或nightly，取决于你项目要求） - 在项目根目录放
rust-toolchain.toml，内容为：[toolchain]<br>channel = "stable"<br>components = ["rust-src", "rust-analyzer"]
——这比rustup default更可靠，能确保每个项目用指定 toolchain - 必须手动安装
rust-src组件：rustup component add rust-src，否则跳转定义失败，报错Failed to load stdlib
VS Code 插件与设置：rust-analyzer 不是“开箱即用”
官方插件 rust-analyzer（由 matklad 维护）是唯一推荐选择，旧插件 Rust（amodrodev）已弃用且不兼容新特性：
- 禁用所有其他 Rust 相关插件，尤其是
RLS和Rust (old) - 在 VS Code 设置中搜索
rust-analyzer，确认启用了rust-analyzer.enable - 关键配置项：
rust-analyzer.cargo.loadOutDirsFromCheck设为true（否则 target/debug/deps 下的符号不可见） - 如果用 workspace（多个 crate），确保
rust-analyzer.cargo.runner留空或设为"cargo"，不要填绝对路径
项目结构与 Cargo.toml：rust-analyzer 只认“合法 crate”
rust-analyzer 不会分析任意 .rs 文件——它只从 Cargo.toml 入口推导 crate graph。常见失效场景：
- 把
.rs文件放在Cargo.toml所在目录之外（比如放在scripts/下），即使语法正确也无法获得补全 -
Cargo.toml缺少[package]或格式错误（如漏掉name字段），会导致整个项目被标记为 “unloaded” - workspace 项目中，
Cargo.toml必须有[workspace]段，且子 crate 的path必须是相对路径（如path = "crates/utils"），不能是../utils - 检查状态栏右下角：显示
rust-analyzer (processing)是正常；若长期卡在rust-analyzer (loading)，大概率是Cargo.lock损坏或依赖解析失败，可删掉重生成
调试与常见报错：别急着重装插件
大部分“不工作”问题其实出在环境链路上，而非插件本身：
- 报错
Unable to find rustc information→ 检查rustc --print sysroot是否有输出，再确认rust-src组件已安装 - 补全缺失、跳转失败 → 打开 VS Code 的
Output面板，选rust-analyzer，看是否有failed to resolve类日志，通常是rust-toolchain.toml未生效或cargo metadata执行失败 - 修改
Cargo.toml后无响应 → 手动触发rust-analyzer.reloadWorkspace（Cmd/Ctrl+Shift+P → 输入该命令） - Windows 上路径含空格导致编译器调用失败 → 把项目移到无空格路径，如
C:\dev\myproject
最易被忽略的是 rust-src 组件和 rust-toolchain.toml 的组合效果——它们共同决定了 rust-analyzer 看到的 std 库版本和 crate 解析起点。一旦这两者不一致，整个语义分析就从底层崩了，表面现象却是“偶尔卡顿”或“部分文件没提示”。
