rust-analyzer 是唯一推荐的 Rust 语言服务器，必须单独安装并禁用旧版“Rust”插件；PATH 未生效会导致加载失败，需确保 VS Code 继承 cargo/rustc 环境；调试须配 CodeLLDB 和 launch.json，且需 rust-src 组件支持标准库跳转。
rust-analyzer 是唯一能用的 Rust 语言服务器，装错插件或 PATH 没生效，VS Code 就只是个高亮编辑器——连 String 都会标红报 unresolved。
rust-analyzer 插件必须单独装，禁用所有叫 “Rust” 的旧插件
VS Code 商店搜 rust-analyzer，认准作者是 matklad（图标为蓝色原子结构），安装后重启。别信“Rust (by rust-lang)”那个红黑熊图标插件——它走已归档的 RLS 协议，不支持 async/await、宏展开等现代特性，且和 rust-analyzer 冲突。打开命令面板（Ctrl+Shift+P），执行 Extensions: Show Enabled Extensions，确认 rust-analyzer 状态为“已启用”，同时 rust-lang.rust 必须禁用。
PATH 不生效是卡在 “Loading…” 的最常见原因
rust-analyzer 启动时要调用 cargo metadata，如果终端里 cargo --version 能输出，但 VS Code 集成终端里报 command not found，说明环境变量没继承过去：
- macOS/Linux：不要从桌面图标启动 VS Code，改用终端执行
code --new-window打开项目；或手动在设置中补全terminal.integrated.env.linux（或.macos）里的PATH - Windows：检查
%USERPROFILE%\.cargo\bin是否在系统 PATH 中；若用 Scoop 安装 rustup，还需确认%USERPROFILE%\scoop\shims已加入 - 验证方式：在 VS Code 集成终端里运行
cargo --version和rustc --version，双命令都必须有输出
调试必须配 CodeLLDB + launch.json，不能靠默认设置
VS Code 自带调试器不支持 Rust，必须装 CodeLLDB（作者 Vadim Chugunov）。调试前先确保生成了 debug 版本二进制：
- 手动执行
cargo build（不是--release），生成./target/debug/<project_name></project_name> - 注意：项目名含连字符（如
my-app）时，Cargo 会转成下划线（my_app），launch.json中的program字段不能写死路径 - 推荐写法：
"program": "${workspaceFolder}/target/debug/${workspaceFolderBasename}"，或更稳妥地用cargo动态构建："cargo": { "args": ["build"] } - Windows 用户若报
cannot find native Windows debugger，说明缺 C++ 构建工具——装 Visual Studio 2022 并勾选“C++ build tools”工作负载
rust-src 组件不装，跳转到标准库就失败
即使 cargo 和 rustc 都正常，rust-analyzer 默认不带标准库源码，点进 Vec::new() 会提示 Failed to load stdlib：
- 运行
rustup component add rust-src补全 - 多 toolchain 场景（如 stable + nightly）下，需对每个 channel 单独加：例如
rustup component add rust-src --toolchain nightly - 若项目用了
rust-toolchain.toml，确保其中components包含"rust-src"
最容易被忽略的是：rust-analyzer 的索引严重依赖 target/ 目录下的中间产物，删掉它不会让项目“更干净”，只会让整个语义分析瘫痪；遇到大面积标红，优先 Reload Workspace 而不是 rm -rf target/。
