如何通过vscode进行Rust编程与编译运行【教程】_网络技术

发布时间 - 2026-01-16 00:00:00 点击率：次

先确认 rustc 和 cargo 可用，再安装 rustup 工具链并配置 PATH；VS Code 只装 rust-analyzer 扩展；新建项目用 cargo new；运行代码优先用 cargo run。

VS Code 本身不编译 Rust，它依赖本地安装的 Rust 工具链。很多人装完插件就急着写代码，结果运行时报 command not found: cargo 或 rustc is not installed。

在终端执行 cargo --version 和 rustc --version，必须都能输出版本号
推荐用 rustup 安装（官网 rustup.rs 提供的一键脚本），不要用系统包管理器（如 apt install rustc），后者常缺 cargo 或版本过旧
安装后确保 $HOME/.cargo/bin（Linux/macOS）或 %USERPROFILE%\.cargo\bin（Windows）已加入 PATH，重启 VS Code 终端才能识别命令

别装 Rust（作者：kalitaalex）那个老扩展，它已弃用，和 carg

o 新版本冲突，会导致自动补全失效、跳转错乱、甚至保存时卡死。

卸载所有其他 Rust 相关扩展，只保留 rust-analyzer（作者：matklad）
安装后无需额外配置，默认即启用；若项目打开后没反应，检查右下角状态栏是否显示 rust-analyzer 正在加载，等待几秒
如遇“no crates loaded”，尝试在项目根目录（含 Cargo.toml）下按 Ctrl+Shift+P → 输入 Rust Analyzer: Reload Workspace

VS Code 不是 IDE，没有“新建 Rust 项目”菜单。手建 main.rs 再配 launch.json 很容易漏掉依赖管理或构建配置。

在终端中进入目标目录，运行 cargo new hello_world（会自动生成 Cargo.toml 和 src/main.rs）
用 VS Code 打开整个 hello_world 文件夹（不是单个 main.rs），否则 rust-analyzer 无法识别 crate 结构
运行代码：终端中执行 cargo run；想调试，按 F5 → 选 Rust → 自动生成 .vscode/launch.json，但注意它默认不启用 args 或环境变量，需手动加

很多人改完代码点 F5 却看不到最新输出，其实是没理解 Cargo 的构建行为。

cargo build 只编译，生成二进制到 target/debug/，不运行
cargo run 编译 + 运行，且默认启用增量编译；若源码未变，会直接运行上次构建产物
调试时 VS Code 默认调用 cargo run，但如果你在 launch.json 中指定了 "program": "./target/debug/hello_world"，就得先手动 cargo build，否则文件不存在
开发中建议始终用 cargo run 启动，避免手动同步构建状态

fn main() {
    println!("Hello, world!");
}

Rust 的编译模型和工具链耦合紧密，VS Code 只是前端。路径没加对、扩展选错、项目结构不对——这三类问题占了新手报错的 80%。别在设置里反复折腾，先让 cargo run 在终端里跑通，再打开 VS Code。