VSCode 找不到 cargo 是因启动时未加载 Cargo 路径：macOS/Linux 未执行 source $HOME/.cargo/env，Windows 未将 %USERPROFILE%.cargo\bin 加入 PATH；需终端运行 code . 或手动配置环境变量并重启 VSCode。
VSCode 本身不管理 Cargo，它只调用系统已安装的 cargo；所有“配置失败”现象，90% 源于 cargo --version 在 VSCode 内置终端里跑不通。
为什么 VSCode 找不到 cargo
不是插件没装、也不是 rust-analyzer 配错了，而是 VSCode 启动时根本没拿到 $HOME/.cargo/bin（macOS/Linux）或 %USERPROFILE%\.cargo\bin（Windows）这个路径。
- macOS/Linux：从桌面图标或 Dock 启动 VSCode，不会加载
~/.zshrc或~/.bash_profile，source $HOME/.cargo/env就没执行 - Windows：用 rustup-init.exe 安装时没勾选 “Add to PATH”，或者安装后没重启 VSCode
- 验证方式：在 VSCode 内置终端（
Ctrl+`）里直接运行cargo --version和rustc --version，两个都必须返回版本号才算过关 - 修复动作：macOS/Linux 改用终端执行
code .打开项目；Windows 手动把%USERPROFILE%\.cargo\bin加进系统环境变量，再彻底关闭并重开 VSCode
保存时自动检查该用 cargo check 而不是 build
cargo build 是为生成可执行文件设计的，每次都要链接依赖、写入 target/、耗时长，还容易因缓存或权限卡住；cargo check 只做语法和类型检查，快、轻、专为编辑反馈优化。
- 别手动写
tasks.json绑定保存事件——rust-analyzer 自带的rust-analyzer.checkOnSave.enable更稳，且错误会原生显示在 Problems 面板 - 启用方式：设置里搜 “Check On Save”，勾上即可；或在项目级
.vscode/settings.json中加："rust-analyzer.checkOnSave.command": "check"
- 如需检查 tests 或所有 features，补上：
"rust-analyzer.checkOnSave.extraArgs": ["--all-targets", "--all-features"]
- 若改了配置但没生效，按
Ctrl+Shift+P→ 输入Rust Analyzer: Reload Workspace手动触发
调试断点不命中，大概率是 launch.json 用了 cargo run
VSCode 默认调试配置生成的是 cargo run，它每次都会重新编译——源码改了但没保存、或 cargo 缓存未更新时，调试器实际加载的是旧二进制，断点自然失效。
- 正确做法：调试前先手动运行一次
cargo build（非--release），确保target/debug/下有最新可执行文件 - 修改
.vscode/launch.json，把"args"改成["build"]，并确认"stopOnEntry": false - 检查
Cargo.toml是否含[profile.dev.debug = 0]—— 这行会关掉调试信息，删掉或设为2 -
"program"字段别硬写成./target/debug/my-app；项目名含连字符（如my-app）时，Cargo 实际生成的是my_app，推荐用动态变量或直接删掉该字段让 CodeLLDB 自动推导
rust-analyzer 不参与构建，只管代码理解
很多人以为 rust-analyzer 能构建或调试，其实它只负责跳转、补全、诊断；真正干活的是 cargo 和 rustc，它们必须独立可用。任何“项目没加载”“标红 String”“跳转失效”，第一步永远是确认 cargo --version 和 rustc --version 在 VSCode 终端里是否都通。
- rust-analyzer 不读
tasks.json，也不影响cargo run的行为；它只依赖cargo metadata输出来建模项目结构 - 禁用所有叫
rust-lang.rust或带rls的插件，只留matklad.rust-analyzer；二者共存会导致 CPU 持续 100% 或静默禁用 - 多 crate workspace 必须在根目录有
Cargo.toml并含[workspace]块，否则 rust-analyzer 会把每个子 crate 当孤立项目处理
