rust-analyzer没反应主因是cargo/rustc未入PATH或rust-lang.rust插件冲突；须在VSCode终端验证版本、禁用旧插件、启用procMacro和loadOutDirsFromCheck等关键配置。
VSCode 本身不带 Rust 支持，装了 rust-analyzer 插件却没反应、跳转失效、标红一堆 String 或 Vec，90% 是因为 cargo 和 rustc 没进 PATH，或旧插件还在后台抢控制权——不是插件装得不对，是环境没对齐。
rustc 和 cargo 必须在 VSCode 终端里能直接运行
rust-analyzer 启动时会调用 cargo metadata 解析项目结构，如果终端里连 cargo --version 都报 command not found，它根本不会开始工作。
- 在 VSCode 集成终端（
Ctrl+`）里执行cargo --version和rustc --version，必须输出版本号；若失败，说明 PATH 没生效 - macOS/Linux 用户常见问题：从桌面图标启动 VSCode，不会加载
~/.zshrc或~/.bash_profile里的 PATH；改用终端执行code --new-window打开项目 - Windows 用户若用 rustup 安装，检查系统环境变量是否含
%USERPROFILE%\.cargo\bin；用 Scoop 安装的，还要确认%USERPROFILE%\scoop\shims在 PATH 中 - 验证 toolchain 是否就绪：
rustup show应显示类似stable-x86_64-unknown-linux-gnu (default)；若为(none)，运行rustup default stable
只装 rust-analyzer，禁用所有叫 “Rust” 的旧插件
VSCode 商店搜 “Rust”，排第一的 Rust（ID: rust-lang.rust）是已弃用的 RLS 插件，和 rust-analyzer 冲突后会导致补全卡死、跳转错乱，甚至让状态栏长期显示 Loading…。
- 必须卸载或禁用
Rust（作者 rust-lang）和任何带rls字样的插件 - 只安装官方
rust-analyzer（ID:matklad.rust-analyzer，图标是蓝色原子结构） - 装完重启 VSCode，打开含
Cargo.toml的目录，右下角状态栏应出现rust-analyzer并有进度条；若静默无反应，按Ctrl+Shift+P→ 输入Extensions: Show Enabled Extensions，确认它确实在“已启用”列表里 - 首次加载可能卡几秒——它在后台跑
cargo metadata --no-deps --format-version 1，别急着重装
rust-analyzer 关键配置项必须设对
默认设置对简单项目够用，但一涉及 workspace、宏展开、条件编译或自定义 target，就得手动干预几个核心开关，否则 #[derive] 不提示、cfg(test) 代码标红、跨 crate 跳转失败。
-
rust-analyzer.cargo.loadOutDirsFromCheck设为true：让插件通过cargo check推导target/下的真实输出路径，否则build.rs生成的模块不可见 -
rust-analyzer.procMacro.enable设为true：开启宏展开支持，serde、sqlx等 derive 宏才能被正确解析 -
rust-analyzer.checkOnSave.command设为check（不是clippy）：保存时轻量检查，避免卡顿；clippy留给 CI 或手动运行 - 多 crate workspace 项目，不要在全局设置里配
rust-analyzer.cargo.args，改用项目根目录的.vscode/settings.json，避免污染其他项目
调试前必须装 CodeLLDB 并配对 program 路径
rust-analyzer 只负责编辑体验，调试靠 CodeLLDB。它不认 target/debug/my-project 这种硬编码路径——Cargo 会把 my-project 中的短横线转成下划线，实际可执行文件名是 my_project。
- 安装
CodeLLDB插件（非必需但强烈推荐），别装lldb或rust-debug等非官方替代品 - 按
Ctrl+Shift+P→Debug: Open launch.json，选CodeLLDB模板，然后把"program"改成："${workspaceFolder}/target/debug/${workspaceFolderBasename}" - 注意：如果项目名含短横线（如
hello-world），Cargo 编译出的二进制是hello_world，所以更稳妥写法是："${workspaceFolder}/target/debug/${workspaceFolderBasename:.replace('-', '_')}"（需 VSCode 1.85+） - 调试前先确保
cargo build成功；若报cannot find executable，优先检查launch.json中的program路径是否拼写错误或未生成
最容易被忽略的是 rust-src 组件没装——它不随 rustup default 自动安装，但没有它，String、Result 这些标准库类型就无法跳转定义。运行 rustup component add rust-src 补上，比反复重装插件管用得多。
