Cargo 必须由 rustup 安装并加入 PATH，VSCode 仅调用；PATH 错误导致 cargo not found；保存检查应使用 cargo check 而非 build；调试前需确保 cargo build 完成且 debug=2。
Cargo 不是 VSCode 插件能“配出来”的工具，它必须由 rustup 安装并暴露在系统 PATH 中；VSCode 只负责调用它——PATH 错了，所有插件和任务都会报 cargo not found。
rustup 装完但 VSCode 找不到 cargo
这不是插件问题，是环境变量没进 VSCode 的启动上下文。
- Linux/macOS：别用桌面图标打开 VSCode，终端里执行
code .（确保 shell 已加载$HOME/.cargo/env） - Windows：如果从开始菜单点开 VSCode，得确认 rustup 安装时勾选了 “Add to PATH”；否则手动把
%USERPROFILE%\.cargo\bin加进系统环境变量 - 验证方式：在 VSCode 内置终端（
Ctrl+`）里直接运行cargo --version和rustc --version，双命令都返回版本号才算过关
保存文件时自动触发 cargo check 而不是 cargo build
用 cargo build 做保存检查是典型误配：它会生成二进制、链接依赖、耗时长，且容易因 target 目录权限或缓存卡住；cargo check 只做语义分析，快、准、专为编辑反馈设计。
- 首选方案：开启
rust-analyzer.checkOnSave.enable（设置里搜 “Check On Save”，勾上即可） - 若需自定义参数（比如检查 tests 或启用所有 features），在
settings.json里加："rust-analyzer.checkOnSave.command": "check", "rust-analyzer.checkOnSave.extraArgs": ["--all-targets", "--all-features"]
- 别手动写 tasks.json 绑定保存事件——rust-analyzer 自带的 checkOnSave 更稳，且和 Problems 面板原生对齐；自己配 task 容易漏
"problemMatcher": "$rust"，导致错误不显示
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（默认值）
最常被忽略的一点：rust-analyzer 从不参与构建或调试，它只管代码理解；真正干活的 cargo 和 rustc 必须独立可用。任何“配置失败”的表象，90% 源于 cargo --version 在 VSCode 终端里跑不通。
