vscode配置rust开发环境的核心前提是cargo和rustc在内置终端中可执行，否则所有功能失效；必须安装rust-analyzer（禁用rust-lang.rust等旧插件），项目根目录需含cargo.toml，并配置.vscode/settings.json启用loadoutdirsfromcheck和procmacro。
VSCode 本身不“配置” Rust 环境，它只调用系统里已装好的 cargo 和 rustc；所有“配不成功”的问题，90% 是因为 cargo --version 在 VSCode 内置终端里根本跑不通。
验证 cargo 和 rustc 是否真可用
这是唯一前置条件，跳过这步后面全白搭。不是看安装程序有没有弹窗，而是直接在 VSCode 里按 Ctrl+` 打开内置终端，敲：
-
cargo --version必须输出类似cargo 1.79.0 -
rustc --version必须输出类似rustc 1.79.0
任一失败，说明 PATH 没进 VSCode 启动上下文：
- Linux/macOS：别用桌面图标启动 VSCode，关掉后在终端执行
code .（确保 shell 已加载$HOME/.cargo/env） - Windows：检查系统环境变量是否含
%USERPROFILE%\.cargo\bin；若 rustup 安装时没勾选 “Add to PATH”，得手动加
只装 rust-analyzer，禁用所有其他 Rust 插件
VSCode 商店搜 “rust-analyzer”，装 matklad.rust-analyzer（蓝色原子图标）。立刻卸载或禁用名为 Rust（作者 rust-lang，红黑齿轮图标）和任何带 RLS、racer 的插件——它们共存会导致 CPU 持续 100%、跳转失效、补全卡死，甚至静默禁用 rust-analyzer。
打开项目后，状态栏右下角应显示 Rust (rust-analyzer)；若显示 Rust (RLS) 或空白，不是插件没装好，是没生效：彻底退出 VSCode，用 code . 从含 Cargo.toml 的目录重开。
确保工作区根目录含 Cargo.toml
rust-analyzer 只认当前工作区根目录下的 Cargo.toml，不会递归搜索子目录。常见错误：
- 你在
~/myproject/crates/utils里有Cargo.toml，但用code .是在~/myproject下执行的 →rust-analyzer看不到它 - 用 File → Open File 直接打开单个
.rs文件 → 它不知道 crate 边界，补全和依赖全失效
正确做法：用 File → Open Folder，选中那个含 Cargo.toml 的文件夹。多 crate 工作区，必须在根目录补一个 [workspace] 声明，或手动建 rust-project.json 显式指定 crate 路径。
调试前必须手动 cargo build，且 debug=2
VSCode 默认调试配置用的是 cargo run，它每次都会重新编译，源码改了没保存、或缓存未更新时，调试器实际加载的是旧二进制——断点自然不命中。
稳定做法：
- 调试前先手动运行
cargo build（非--release） - 确认
Cargo.toml里没有[profile.dev.debug = 0]（这会 strip 调试信息），默认是2，删掉或设为2 - 修改
.vscode/launch.json："args"改成["build"]，"program"别硬写路径，用"${workspaceFolder}/target/debug/${workspaceFolderBasename}"（注意：Cargo 把-自动转成_，my-app对应二进制名是my_app）
真正容易被忽略的点：VSCode 的 reload window 不刷新环境变量，PATH 错了必须彻底退出再重开；cargo check 是编辑时该用的命令，cargo build 是调试前该做的动作——混用就卡住。
