Rust编译器和Cargo安装是否成功？需在新终端中运行cargo --version和rustc --version均返回结果；VSCode仅装rust-analyzer插件，确保状态栏显示“Rust (rust-analyzer)”，并配置rust-analyzer checkOnSave为true、server.path指向本地二进制。
Rust编译器和cargo安装是否成功？
先确认底层工具链有没有真正装好，很多人卡在这步却以为是VSCode配置问题。cargo不是独立安装的，它随rustup一起下来。运行：
cargo --version如果报
command not found，说明rustup没加进PATH，或者根本没装。macOS/Linux用户常漏掉source $HOME/.cargo/env这句；Windows用PowerShell安装后，得重启终端或手动刷新环境变量。别信“安装完成”的弹窗，一定要在新终端里验证cargo --version和rustc --version都返回结果。
VSCode插件只装rust-analyzer，别碰racer或rls
老教程常推荐racer或rls，现在全过时了。Rust官方主推rust-analyzer，它支持cargo check实时诊断、跨crate跳转、更准的补全。装完插件后，VSCode右下角状态栏会显示Rust (rust-analyzer)，如果显示Rust (RLS)或空白，说明没生效——关掉所有窗口，用code .从项目根目录启动VSCode，确保它读到Cargo.toml。插件默认启用cargo check，但如果你关过“Check on save”，得去设置里搜rust-analyzer checkOnSave，设为true。
cargo check不自动触发？检查workspace和target路径
cargo check只对当前workspace root有效。常见坑：
- 你在子目录打开VSCode（比如
cd crates/my-lib && code .），cargo check会失败，因为找不到Cargo.toml - 项目是workspace，但根目录没有
Cargo.toml（只有crates/xxx/Cargo.toml），这时得在根目录补一个[workspace]声明 -
cargo check默认不检查tests/benches，想让它扫#[cfg(test)]代码，得加参数：cargo check --all-targets，对应到rust-analyzer配置项是rust-analyzer cargo allFeatures和rust-analyzer cargo extraArgs（填["--all-targets"]）
错误提示不出现或延迟高？调大rust-analyzer内存和超时
默认配置下，大型项目（尤其带proc-macro或async-trait）容易卡住，表现为：保存后几秒没提示、cargo check图标一直转圈、跳转失效。解决方法：
- 在VSCode设置里搜
rust-analyzer server.extraEnv，加{"RUSTC_WRAPPER": "sccache"}（需提前装sccache） - 搜
rust-analyzer server.extraArgs，加["--no-system-libs"]减少扫描范围 - 最关键：搜
rust-analyzer server.path，确保指向本地cargo-bin下的rust-analyzer二进制，别用插件内置版本（慢且功能少）
rust-analyzer的cargo check本质是后台跑cargo check --message-format=json，所以它依赖Cargo本身的稳定性。如果cargo check命令行能跑通但VSCode里不动，八成是插件没拿到正确工作区路径，或者rust-analyzer进程被系统杀掉了——看输出面板里“Rust Analyzer”频道的原始日志，比界面提示靠谱得多。
