rust-analyzer未响应需先确认是否运行：打开含Cargo.toml的目录，用命令“Rust Analyzer: Show Server Status”检查状态；若失败则排查rustup工具链、项目路径（禁用中文路径）、工作区配置及关闭checkOnSave优化性能。
rust-analyzer 装了但没反应？先确认它是不是真在跑
很多人装完 rust-analyzer 插件，打开 .rs 文件还是没语法高亮、跳转失效、类型提示空白——不是插件没装，而是它根本没启动成功。VSCode 默认不会自动启用 rust-analyzer，除非检测到项目根目录有 Cargo.toml 或明确配置了 rust-analyzer.server.path。
- 打开一个含
Cargo.toml的目录（比如cargo new hello新建的项目），而不是单个.rs文件 - 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Rust Analyzer: Show Server Status，看状态是否为running - 如果显示
failed to start，大概率是rustup没装或工具链未初始化：终端运行rustup toolchain list，至少要有stable-x86_64-unknown-linux-gnu（或对应平台）
rust-analyzer 报 “Failed to load workspace” 怎么办
这个错误常见于项目结构不标准，或 rust-analyzer 找不到正确的 Cargo 工作区入口。它不像 cargo check 那样能自动向上递归找 Cargo.toml，默认只认当前打开文件夹下的顶层 Cargo.toml。
- 如果你打开的是子目录（比如
my-project/crates/utils），但Cargo.toml在my-project/，就手动用 VSCode「文件 → 将文件夹添加到工作区」，选最外层含Cargo.toml的目录 - 多工作区项目（如含
workspace = true的根Cargo.toml）必须确保根目录被打开，否则rust-analyzer会把每个 crate 当孤立项目处理，跨 crate 跳转失败 - 临时解决可加配置：
"rust-analyzer.cargo.loadOutDirsFromCheck": true，让分析器从cargo check输出反推路径，但会变慢
代码补全卡顿、跳转慢？关掉 cargo-check-on-save
rust-analyzer 默认会在保存时触发 cargo check，对小项目没问题，但一旦依赖多（比如用了 tokio + serde + sqlx），每次保存都等 2–5 秒，编辑体验直接崩。这不是插件 bug，是它把“实时性”和“准确性”绑太死了。
- 在 VSCode 设置里搜
rust-analyzer.checkOnSave.command，把它改成check（默认是checkOnSave）——这会让检查退到后台异步做，不阻塞编辑 - 更激进一点：设
"rust-analyzer.cargo.autoreload": false，避免 Cargo.toml 改动后自动重载整个分析器（重载过程常卡住） - 注意：关掉自动检查后，
#[derive(...)]衍生宏报错可能延迟出现，得手动按Ctrl+Shift+P→Rust Analyzer: Run Cargo Check
Windows 上中文路径导致 rust-analyzer 崩溃
这是个长期存在的兼容问题：rust-analyzer 在 Windows 下对非 ASCII 路径（含中文、日文、空格、括号）解析不稳定，经常表现为服务器反复崩溃、日志里刷一堆 Os { code: 123, kind: InvalidData, message: "The filename, directory name, or volume label syntax is incorrect." }。
- 最稳解法：把项目移到纯英文路径下，比如
C:\dev\rust-projects\myapp，别用C:\用户\张三\文档\Rust项目 - 如果必须用中文路径，可尝试在 VSCode 设置里加：
"rust-analyzer.server.extraEnv": { "RUST_ANALYZER_NO_SYMLINKS": "1" }，禁用符号链接解析，有时能绕过路径 decode 失败 - 别信“改系统区域设置”或“用 WSL 路径映射”，实测多数无效，且引入新层抽象后调试更难
真正麻烦的从来不是装不上，而是装上了却不知道它在哪一步悄悄放弃了——比如 workspace 没识别、路径里有个隐藏的 .git 子模块干扰了 Cargo 解析、或者 rustup default stable 后忘了 rustup component add rust-analyzer。这些点不报红，只静默降级功能。
