1. 下载并安装 Rust 官方工具链#

Rust 官方推荐使用 rustup 来管理编译器版本和工具链。

• 官网下载：访问 https://www.rust-lang.org/。
• Windows 下载指引：在官网点击“Get Started”，下载 rustup-init.exe（通常选择 64-bit）。
• 启动安装：
  1. 双击运行 rustup-init.exe，此时会弹出一个黑色终端。
  2. 如果系统提示需要安装 Microsoft C++ Build Tools，请按照提示先前往微软官网下载 Visual Studio Installer 并勾选 “使用 C++ 的桌面开发” 进行安装（Rust 编译底层依赖它）。
  3. 准备就绪后，在 rustup 终端中看到提示，直接输入 1 并回车，选择 1) Proceed with standard installation (default) 进行默认安装。

TIP

因为 Rust 官方源在国内下载可能较慢，如果在安装时卡住，可以在运行安装程序前，先在 Windows 系统变量中添加以下官方生态的全球或国内镜像加速环境变量： RUSTUP_DIST_SERVER = https://mirrors.ustc.edu.cn/rust-static RUSTUP_UPDATE_ROOT = https://mirrors.ustc.edu.cn/rust-static/rustup

2. 验证安装与环境变量#

rustup 非常智能，在安装过程中会自动将 Rust 的编译器 rustc 和包管理器 cargo 添加到你的系统 Path 环境变量中。

• 验证步骤：
  1. 按下 Win + r，输入 cmd 打开命令提示符。
  2. 分别输入以下两条命令检查版本：

     1
     rustc --version
     2
     cargo --version
     

  3. 如果正确打印出版本号（如 rustc 1.85.0 ...），说明安装大功告成。

3. 配置 VScode 插件#

打开 VScode，进入扩展商店（Ctrl + Shift + X），搜索并安装以下 Rust 核心开发插件：

• rust-analyzer【必备】：官方极力推荐的 Rust 语言服务器插件，提供极为强大的代码补全、实时语法检查、类型推导和错误跳转。
• Even Better TOML【必备】：Rust 的项目配置文件 Cargo.toml 使用的是 TOML 语法，该插件专门用来为它提供高亮和格式化。
• CodeLLDB【推荐】：用于在 Windows 下完美调试 Rust 代码，支持加断点、单步调试等硬核操作。

4. 运行代码测试#

Rust 拥有极其现代化的项目构建工具 Cargo，我们不需要像 C 语言那样手动建立 .c 文件，一切交给 Cargo 来自动化管理。

• 创建项目：
  1. 在你存放代码的目录下打开终端（或在 VScode 的集成终端中）。
  2. 运行命令创建一个名为 hello_rust 的新项目：

     1
     cargo new hello_rust
     

  3. 此时 Cargo 会自动生成一个标准的项目目录。
• 编写代码：
  1. 在 VScode 中“通过Code打开”这个 hello_rust 文件夹。
  2. 打开 src/main.rs 文件，你会发现 Cargo 已经为你初始化好了经典的测试代码：

1
fn main() {
2
    println!("Hello, World!");
3
    println!("你好，Rust！");
4
}

• 运行程序：
  1. 无需任何复杂配置，直接在 VScode 终端中运行：

     1
     cargo run
     

  2. 程序会自动完成编译（Compile）并直接输出运行结果。

5. 调整与优化：一键 F5 启动调试#

为了不用每次都手敲 cargo run，我们可以利用 CodeLLDB 插件实现一键 F5 编译、运行与调试。

TIP

代码文件夹被 VScode 打开后，在根目录下手动创建 .vscode 文件夹，并在其中新建 launch.json。

• 配置 launch.json：将以下标准的 Cargo 调试配置粘贴进去并保存：

1
{
2
    "version": "0.2.0",
3
    "configurations": [
4
        {
5
            "type": "lldb",
6
            "request": "launch",
7
            "name": "F5 调试 Rust 项目",
8
            "cargo": {
9
                "args": [
10
                    "build",
11
                    "--bin=hello_rust"
12
                ],
13
                "filter": {
14
                    "name": "hello_rust",
15
                    "kind": "bin"
16
                }
17
            },
18
            "args": [],
19
            "cwd": "${workspaceFolder}"
20
        }
21
    ]
22
}

注意：将其中的 hello_rust 改为你自己创建的 Cargo 项目名称。保存后，直接在 main.rs 中按下 F5 即可实现一键可视化调试。

6. 提示#

1. Rust 的包管理器 Cargo 在首次下载依赖库时（写在 Cargo.toml 中的第三方库），会联网拉取。因为海外网络环境畅通，无需配置国内 crates.io 镜像源，可直接享受官方原生源的丝滑同步体验。
2. 同 C 语言一样，请确保你的项目路径和系统用户名尽量避免使用中文和特殊字符，以防编译器底层组件在解析路径时报错。