cargo run是唯一真正运行rust程序的命令，vscode仅作为前端调用它；报“command not found”主因是启动时未继承shell path，需在集成终端验证cargo --version和rustc --version，mac/linux应终端执行code .启动，windows需确保%userprofile%.cargo\bin在系统path中。
cargo run 是唯一真正运行 Rust 程序的命令，VSCode 本身不编译、不执行，它只是调用这个命令的前端界面。装了 rust-analyzer 却找不到“运行”按钮，不是插件没装对，而是误把语言服务器当构建工具用了。
为什么 VSCode 里敲 cargo run 报 “command not found”
这不是插件问题，是 VSCode 启动时没继承 shell 的 PATH。Mac/Linux 用户双击图标启动 VSCode，$HOME/.cargo/bin 就不会被加载；Windows 用户若安装 rustup-init.exe 时没勾选 “Add to PATH”，%USERPROFILE%\.cargo\bin 就不在系统变量里。
- 验证方式：在 VSCode 集成终端（
Ctrl+`）中运行cargo --version和rustc --version，两个都必须有输出 - Mac/Linux：关闭 VSCode，从终端进入项目根目录（含
Cargo.toml），执行code . - Windows：检查系统环境变量是否包含
%USERPROFILE%\.cargo\bin；若无，重装rustup-init.exe并务必勾选 “Add to PATH” - 别依赖 “Reload Window”——它不刷新环境变量，必须彻底退出再重开
怎么在 VSCode 里一键运行，而不是配 tasks.json
日常运行不需要手动写 tasks.json 或 launch.json。最简路径就是终端直跑，稳定且可控。
- 确保当前工作目录是项目根（含
Cargo.toml），不是src/或父级空文件夹 - 按
Ctrl+`呼出集成终端，直接敲cargo run - 想用快捷键触发：按
Ctrl+Shift+P→ 输入Tasks: Run Task→ 选cargo run（首次会自动生成.vscode/tasks.json，内容为"args": ["run"]） -
cargo check不等于运行，它不生成可执行文件；没保存文件就运行，跑的还是旧代码
调试时断点不命中，launch.json 怎么配才靠谱
VSCode 默认生成的调试配置常写死路径或用 cargo run，导致断点失效、二进制名错配（如 my-app 编译成 my_app）、debug info 被关。
- 先手动执行
cargo build（非--release），确认./target/debug/${workspaceFolderBasename}存在 - 修改
.vscode/launch.json："args"改成["build"]，避免每次调试都重新编译 -
"program"别硬写成./target/debug/my-app，改用动态路径："${workspaceFolder}/target/debug/${workspaceFolderBasename}" - 检查
Cargo.toml是否有[profile.dev.debug = 0]—— 这行会关掉调试信息，删掉或设为2 - 多 crate workspace 下，
cargo字段里加"filter"明确指定 binary，例如"name": "my_bin", "kind": "bin"
真正卡住人的地方从来不是语法或配置项本身，而是 cargo --version 在 VSCode 终端里跑不通——所有“运行不了”“调试失败”“跳转失效”的表象，90% 源于此。环境变量没进进程上下文，插件再好也白搭。
