VSCode配置Rust开发环境需同时满足三要素：正确安装rustup工具链并确保cargo/rustc在PATH中、安装官方rust-analyzer插件（禁用已弃用的rust-lang.rust插件）、在含Cargo.toml的目录下打开项目；缺任一环均导致“unresolved”报错或卡在“Loading…”。
VSCode 本身不支持 Rust，装错插件或 cargo 不在 PATH 中，rust-analyzer 就启动不了——连 String 都会标红报 unresolved，不是代码问题，是环境根本没跑起来。
rust-analyzer 必须装，Rust（rust-lang）插件必须禁用
VS Code 商店搜 “Rust” 会出现两个高星插件：rust-lang.rust（红黑熊图标）和 matklad.rust-analyzer（蓝色原子结构）。前者走已归档的 RLS 协议，不支持 async/await、宏展开、proc-macro，且与 rust-analyzer 冲突。
- 卸载或禁用
rust-lang.rust插件，哪怕它显示“已启用”也得关掉 - 只安装
matklad.rust-analyzer，安装后必须重启 VS Code - 打开含
Cargo.toml的目录（不是子文件夹），状态栏右下角应出现[rust-analyzer]并有进度条 - 若卡在 “Loading…”，按
Ctrl+Shift+P→ 输入Rust Analyzer: Reload Workspace手动触发
cargo 和 rustc 必须在 VS Code 终端里能执行
cargo --version 在系统终端能跑，但在 VS Code 集成终端里报 command not found，这是最常见卡点。本质是 VS Code 启动时没继承 shell 的 PATH。
- macOS/Linux：别双击图标启动 VS Code；关闭后从终端执行
code .（当前目录需为项目根） - Windows：检查系统环境变量是否包含
%USERPROFILE%\.cargo\bin；若用 Scoop 安装 rustup，还需确认%USERPROFILE%\scoop\shims已加入 PATH - 验证方式：在 VS Code 集成终端中运行
cargo --version和rustc --version，两者都必须输出版本号 - 若仍失败，可在 VS Code 设置中手动补全：
terminal.integrated.env.macos或.linux里加"PATH": "/Users/xxx/.cargo/bin:${env:PATH}"
调试必须配 CodeLLDB + launch.json，不能靠默认设置
VS Code 自带调试器不支持 Rust。装了 CodeLLDB（作者 Vadim Chugunov）后，还必须确保生成的是 debug 版本二进制，且 launch.json 中的路径不写死。
- 先手动执行
cargo build（不是--release），生成./target/debug/<project_name> - 项目名含连字符（如
my-app）时，Cargo 编译后实际为my_app，硬写"program": "./target/debug/my-app"必然失败 - 推荐写法：
"program": "${workspaceFolder}/target/debug/${workspaceFolderBasename}" - Windows 若报
cannot find native Windows debugger，说明缺 C++ 构建工具——装 Visual Studio 2022 并勾选 “C++ build tools” 工作负载
rust-src 组件不装，标准库跳转就失效
即使 cargo 和 rust-analyzer 都正常，String、Vec 等类型点不进去，大概率是缺 rust-src 组件。
- 运行
rustup component add rust-src安装（注意不是rustup install rust-src） - 该组件只对当前 toolchain 生效；若用
rust-toolchain.toml指定了nightly，就得先rustup default nightly再装 - 装完后，
rust-analyzer会自动加载 stdlib metadata；若没反应，手动Reload Workspace - 不装这个，
#[derive(Debug)]里的Debug也点不进标准库定义
最容易被忽略的是：删掉 target/ 目录后，rust-analyzer 的语义索引就断了，但 cargo check 仍能过——这时候 reload workspace 是唯一快速恢复的方式，不是重装插件也不是重装 rustup。
