rust-analyzer 能用的前提是：1. VSCode 打开含 Cargo.toml 的目录；2. 终端可运行 cargo --version 和 rustc --version；3. 禁用 rust-lang.rust 插件。任一不满足则卡在 loading 或不显示。
rust-analyzer 插件装上不等于能用，90% 的问题出在环境链路断了——不是插件坏了，是它根本没连上 cargo 和 rustc。
rust-analyzer 启动失败的三个硬性前提
它只在满足全部以下条件时才会真正启动：
- VSCode 打开的是 包含
Cargo.toml的目录（不是单个.rs文件，也不是父级空文件夹） - 终端里能直接运行
cargo --version和rustc --version，且输出正常 - 插件列表中
rust-lang.rust已被禁用（它和rust-analyzer冲突，共存必废）
任意一条不满足，状态栏右下角就只会显示 rust-analyzer (loading) 卡死，或压根不出现。别急着重装插件，先按这三条挨个核对。
Mac/Linux 下 VSCode 找不到 cargo 的真实原因
桌面图标启动的 VSCode 不加载 ~/.zshrc 或 ~/.bash_profile，$PATH 里没有 $HOME/.cargo/bin ——所以 cargo 命令在 VSCode 终端里就执行不了，rust-analyzer 自然启动失败。
- 验证方式：在 VSCode 内置终端里输入
cargo --version，报command not found就是它 - 临时解决：从系统终端执行
code --new-window启动 VSCode（继承 shell 环境） - 永久解决：把
export PATH="$HOME/.cargo/bin:$PATH"加进你的 shell 配置文件，然后重启终端再启动 VSCode
多 crate workspace 项目跳转失效怎么办
rust-analyzer 必须通过根目录的 Cargo.toml 解析整个 workspace 结构。如果打开的是子 crate 目录，或根 Cargo.toml 没写 [workspace] 块，它就把每个 crate 当成孤立项目处理，跨 crate 的函数跳转、类型补全全部失效。
- 检查点：根目录
Cargo.toml是否含[workspace]，且members列表正确列出所有子 crate 路径 - 常见坑：
members = ["crates/*"]这种通配写法在某些 rustup 版本下不被识别，建议写死路径如["crates/utils", "crates/core"] - 补救配置（仅应急）：
"rust-analyzer.cargo.loadOutDirsFromCheck": true，让分析器从cargo check输出反推构建路径，但会变慢、不准
为什么改了代码没提示、补全延迟、CPU 一直 100%
默认配置会让 rust-analyzer 索引全部依赖源码（包括 std 和所有 crates.io 依赖），小项目浪费资源，大 workspace 直接拖垮响应速度。
- 立即生效的降负载配置：
"rust-analyzer.cargo.autoreload": false（关掉 Cargo.toml 变更自动重载） - 更关键的开关：
"rust-analyzer.checkOnSave.command": "check"（不是checkOnSave），否则保存时会同步阻塞编辑 - 必须加的组件：
rustup component add rust-src，否则跳转进标准库直接失败，报Failed to load stdlib
这些配置不是“可选优化”，而是 rust-analyzer 在非玩具项目里保持可用性的底线设置。漏掉任意一项，都可能让智能提示退化成纯语法高亮。
