如何通过vscode进行Rust编程与编译运行【教程】

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

安装 Rust 工具链前先确认 rustc 和 cargo 是否可用

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 终端才能识别命令

VS Code 必装扩展：只留 rust-analyzer

别装 Rust（作者：kalitaalex）那个老扩展，它已弃用，和 cargo 新版本冲突，会导致自动补全失效、跳转错乱、甚至保存时卡死。

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

新建项目别手动建文件夹，直接用 cargo new

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

Tago AI

AI生成带货视频，专为电商卖货而生

下载

• 在终端中进入目标目录，运行 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 或环境变量，需手动加

cargo run 和 cargo build 的区别直接影响调试体验

很多人改完代码点 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!");
}