必须同时满足：PATH含cargo/rustc、VS Code装rust-analyzer（非Rust插件）、项目根目录有Cargo.toml；任一缺失会导致加载卡顿、标红、跳转失效或补全空白。
能用就行，但必须同时满足三个条件：系统 PATH 里有 cargo 和 rustc，VS Code 装的是 rust-analyzer（不是“Rust”插件），项目根目录含 Cargo.toml。缺任何一个，就会卡在 “Loading…”、标红 String、跳转失效或补全空白。
rustc/cargo 找不到？先查终端和 VS Code 的 PATH 是否一致
很多人在系统终端跑 cargo --version 没问题，但在 VS Code 集成终端里报 command not found——这不是 rustup 没装好，而是 VS Code 启动时没继承 shell 的环境变量。
- macOS/Linux：别从桌面图标启动 VS Code，改用终端执行
code .；如果必须图形启动，手动在 VS Code 设置中补全terminal.integrated.env.macos或.linux，例如："PATH": "/Users/xxx/.cargo/bin:${env:PATH}" - Windows：确认
%USERPROFILE%\.cargo\bin已加入系统 PATH（控制面板 → 系统 → 高级系统设置 → 环境变量）；若用 Scoop 安装 rustup，还要把%USERPROFILE%\scoop\shims加进去 - 验证方式：打开 VS Code 集成终端，直接运行
cargo --version和rustc --version，两个都必须输出版本号
装了“Rust”插件却没反应？你可能启用了已弃用的旧插件
VS Code 商店搜 “Rust”，会出现两个高星插件：Rust（作者 rust-lang，红黑熊图标）和 rust-analyzer（作者 matklad，蓝色原子图标）。前者基于已归档的 RLS 协议，不支持 async/await、宏展开、#[derive] 提示等现代特性，且与 rust-analyzer 冲突。
- 必须卸载或禁用
Rust（rust-lang.rust）插件，只保留rust-analyzer - 打开命令面板（
Ctrl+Shift+P），执行Extensions: Show Enabled Extensions，确认只有rust-analyzer处于启用状态 - 首次打开含
Cargo.toml的目录后，右下角应出现rust-analyzer状态栏，进度条走完显示Ready；若长期卡住，按Ctrl+Shift+P→ 输入Rust Analyzer: Reload Workspace手动触发
代码能编译但 rust-analyzer 标红“unresolved import”？别乱删 target/
cargo check 成功但编辑器里大量符号报错，最常见原因是手动执行了 rm -rf target/。rust-analyzer 依赖 target/ 下的 rustc 编译产物（如 target/debug/deps 中的 rmeta 文件）构建语义索引，清空后不会自动重建。
- 开发中避免
rm -rf target/；清理缓存请用cargo clean --release或只删target/debug/deps - 误删后，执行
Rust Analyzer: Reload Workspace，再等它重新跑完cargo check推导路径 - 为防反复出问题，建议在项目根目录的
.vscode/settings.json中加配置："rust-analyzer.cargo.loadOutDirsFromCheck": true，让插件通过cargo check输出反推构建路径
调试断点不命中？launch.json 必须匹配 debug 构建产物
VS Code 自带调试器不支持 Rust，必须装 CodeLLDB 插件（作者 Vadim Chugunov），且 launch.json 中的 program 字段不能硬编码路径。
- 先确保已运行
cargo build（非--release），生成target/debug/myapp -
launch.json中写成："program": "${workspaceFolder}/target/debug/${fileBasenameNoExtension}"，而不是"./target/debug/myapp" - Windows 用户若报
cannot find native Windows debugger，说明缺少 C++ 构建工具——装 Visual Studio 2022 并勾选 “C++ build tools” 工作负载 - 标准库跳转失效？运行
rustup component add rust-src补全源码组件
最容易被忽略的是：rust-analyzer 不会自动监听 Cargo.toml 变更，默认改了依赖也不会重载分析模型。真要开热重载，得手动设 "rust-analyzer.cargo.watch": true，否则加了 serde 还是提示 unresolved。
