VSCode 本身不运行 Rust 代码，rust-analyzer 仅作语言分析；真正运行需在集成终端执行 cargo run，前提是 VSCode 终端能识别 cargo 和 rustc，且项目根目录含 Cargo.toml。
VSCode 本身不提供 Rust 运行能力，rust-analyzer 也不负责执行代码——它只做分析。点不了“运行”按钮不是插件没装好，而是你误把语言服务器当成了执行器。
为什么点“运行”没反应或报 command not found
根本原因：VSCode 没继承到 cargo 的路径，或者根本没在正确位置打开项目。
-
cargo和rustc必须能在 VSCode 集成终端（Ctrl+`）中直接运行；若报command not found，说明$HOME/.cargo/bin（macOS/Linux）或%USERPROFILE%\.cargo\bin（Windows）没进 PATH - 从桌面图标、开始菜单或文件管理器双击打开 VSCode，通常不会加载 shell 配置（如
~/.zshrc），PATH 就断了 - 必须用终端进入含
Cargo.toml的目录后，执行code .打开项目；打开单个.rs文件或父级空文件夹，rust-analyzer会直接判定 “No Rust project detected” - 远程开发（SSH/WSL）时，需手动在
settings.json中指定："rust-analyzer.cargo.path": "/home/xxx/.cargo/bin/cargo"和"rust-analyzer.server.extraEnv": { "PATH": "/home/xxx/.cargo/bin:${env:PATH}" }
如何真正运行 Rust 代码（不用插件按钮）
别等“运行”按钮出现——它本来就不存在。可靠方式只有两种：
- 在集成终端（
Ctrl+`）中手动执行：cargo run（首次会编译并运行）或cargo run --bin myapp（多二进制项目） - 用 VSCode 原生任务系统：
Ctrl+Shift+P→ 输入Tasks: Run Task→ 选cargo run（首次会引导生成.vscode/tasks.json） - 注意：
cargo run要求当前工作区根目录下有有效的Cargo.toml，且不能是 workspace 子 crate 目录（必须打开最外层[workspace]所在目录）
调试前必须确认的三件事
断点不命中、launch.json 报错、程序闪退，90% 出在这三处。
-
rust-analyzer必须已启用且完成加载：状态栏右下角显示[rust-analyzer]并无Loading…卡死；否则 CodeLLDB 拿不到符号信息 - 必须安装
CodeLLDB插件（不是rust-lang.rust或vscode-lldb），且 macOS/Linux 已装lldb、Windows 已装 Visual Studio “C++ build tools” -
launch.json中的"program"必须用变量动态构造："${workspaceFolder}/target/debug/${workspaceFolderBasename}"；硬写./target/debug/my-app在项目名含连字符或大小写不一致时必然失败
最容易被忽略的是：rust-analyzer 启动失败时，VSCode 不报红错，只静默卡在 “Loading…”；这时候无论你怎么配 launch.json 或重装插件都没用——得先让它看见 cargo、找到 Cargo.toml、顺利跑完 cargo metadata。
