VSCode运行Rust代码：环境配置与Cargo插件使用-VSCode-PHP中文网

vscode 运行 rust 依赖系统 cargo/rustc，必须先验证其可用性；仅启用 rust-analyzer 插件；保存时用 cargo check 而非 build；调试前需手动 build 并正确配置 launch.json。

vscode运行rust代码：环境配置与cargo插件使用

VSCode 本身不运行 Rust 代码，它只调用系统中已安装的 cargo 和 rustc；所有“点一下就跑”的失败，90% 是因为 cargo --version 在 VSCode 内置终端里根本执行不了。

验证 cargo 和 rustc 是否真可用

这是整个流程的地基。别信安装弹窗，也别跳过这步——很多“插件没反应”“报 No Rust project detected”的问题，源头就在这儿。

在 VSCode 里按 Ctrl+` 打开内置终端，直接运行：cargo --version 和 rustc --version
两个命令都必须输出类似 cargo 1.79.0、rustc 1.79.0 的结果，才算过关
如果任一报 command not found，说明 VSCode 启动时没拿到 $HOME/.cargo/bin（macOS/Linux）或 %USERPROFILE%\.cargo\bin（Windows）这个路径
macOS/Linux：关掉 VSCode，从终端执行 code .（确保当前目录是项目根），它会继承 shell 环境变量
Windows：检查系统环境变量是否含 %USERPROFILE%\.cargo\bin；若没有，重装 rustup-init.exe 并务必勾选 “Add to PATH”

只装 rust-analyzer，禁用所有旧 Rust 插件

VSCode 商店搜 “Rust”，你会看到两个高星插件：rust-lang.rust（红黑齿轮图标，已废弃）和 matklad.rust-analyzer（蓝色原子图标，当前唯一标准）。二者共存会导致 CPU 持续 100%、跳转失效、补全卡死，甚至静默禁用 rust-analyzer。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

必须卸载或禁用 rust-lang.rust
必须安装 matklad.rust-analyzer
装完后，打开含 Cargo.toml 的目录（不是子文件夹），状态栏右下角应显示 Rust (rust-analyzer)
若显示 Rust (RLS) 或空白，说明没生效——彻底关闭所有 VSCode 窗口，再用 code . 从项目根目录重开
仍卡在 “Loading…”？按 Ctrl+Shift+P → 输入 Rust Analyzer: Reload Workspace 手动触发

保存时自动检查用 cargo check，不是 build

cargo build 是为生成可执行文件设计的，每次都要链接依赖、写入 target/、耗时长，还容易因缓存或权限卡住；cargo check 只做语法和类型检查，快、轻、专为编辑反馈优化。

启用方式：设置里搜 “Check On Save”，勾上 rust-analyzer.checkOnSave.enable

或在项目级 .vscode/settings.json 中加：

{"rust-analyzer.checkOnSave.command":"check"}

如需检查 tests 或所有 features，补上：

"rust-analyzer.checkOnSave.extraArgs": ["--all-targets","--all-features"]

别手动写 tasks.json 绑定保存事件——rust-analyzer 自带的 checkOnSave 更稳，且错误会原生显示在 Problems 面板

调试前必须先 cargo build，launch.json 别用 cargo run

VSCode 默认生成的 launch.json 往往用 cargo run，它每次都会重新编译。源码改了但没保存、或 cargo 缓存未更新时，调试器实际加载的是旧二进制，断点自然失效。

正确做法：调试前先手动运行一次 cargo build（非 --release），确保 target/debug/ 下有最新可执行文件
修改 .vscode/launch.json，把 "args" 改成 ["build"]，并确认 "stopOnEntry": false
"program" 别硬写 ./target/debug/my-app，改用动态路径：
```
"program": "${workspaceFolder}/target/debug/${workspaceFolderBasename}"
```
（注意：Cargo 会自动把 - 转成 _，所以 my-app 对应二进制名是 my_app）
检查 Cargo.toml 是否含 [profile.dev.debug = 0]——这行会关掉调试信息，删掉或设为 2

最常被忽略的一点是：rust-analyzer 依赖 target/ 目录下的构建产物生成语义索引。误删 target/ 后，即使代码能编译通过，也会大量报 unresolved import 或跳转失败——这时别反复重装插件，执行 Rust Analyzer: Reload Workspace 就行。