Windows 下 Rust 快速安装指南

以下是为前端开发工程师定制的 Windows 下 Rust 快速安装指南，结合你已安装的 VS Code 环境，从安装到开发环境配置一步到位：

一、安装 Rust 前的必要准备

1. 安装 C++ 构建工具

Rust 在 Windows 默认依赖 Microsoft C++ 构建工具（推荐）或 MinGW（轻量但需手动配置）。

推荐方案（MSVC） ：
下载 Visual Studio 2022 Build Tools，勾选 "使用 C++ 的桌面开发" 组件。
替代方案（MinGW） ：
若希望轻量安装，可下载 MinGW-w64，解压后添加 bin 目录到系统环境变量 PATH。

2. 配置国内镜像加速

为避免下载卡顿，提前设置 Rust 工具链和 Cargo 包的国内镜像：

PowerShell 中设置环境变量 ：

powershell 复制代码

[Environment]::SetEnvironmentVariable("RUSTUP_DIST_SERVER", "https://mirrors.ustc.edu.cn/rust-static", "User")
[Environment]::SetEnvironmentVariable("RUSTUP_UPDATE_ROOT", "https://mirrors.ustc.edu.cn/rust-static/rustup", "User")

Cargo 镜像配置 ：
在 C:\Users\<用户名>\.cargo\config 中添加：

toml 复制代码

[source.crates-io]
replace-with = 'ustc'
[source.ustc]
registry = "https://mirrors.ustc.edu.cn/crates.io-index"

二、安装 Rust 工具链

1. 下载并运行安装程序

访问 Rust 官网，下载 rustup-init.exe。
双击运行 ，按提示输入 1 选择默认安装（推荐 MSVC 工具链）。

2. 验证安装

安装完成后，重启终端并运行：

bash 复制代码

rustc --version  # 输出版本号如 rustc 1.78.0
cargo --version  # 输出 Cargo 版本号

若命令未识别，检查环境变量 PATH 是否包含 %USERPROFILE%\.cargo\bin。

三、配置 VS Code 开发环境

1. 安装必备插件

rust-analyzer：实时语法检查与代码补全。
CodeLLDB：集成调试支持。
Even Better TOML ：优化 Cargo.toml 编辑体验。

2. 启用自动格式化

在 VS Code 设置中搜索 Format On Save 并启用，安装 Rust 格式化工具：

bash 复制代码

rustup component add rustfmt  # 安装 rustfmt

四、创建第一个 Rust 项目

1. 初始化项目

bash 复制代码

cargo new hello_rust  # 创建项目
cd hello_rust
code .               # 用 VS Code 打开

项目结构：

复制代码

hello_rust/
├── Cargo.toml    # 依赖管理（类似 package.json）
└── src/
    └── main.rs   # 入口文件

2. 编写与运行代码

在 main.rs 中添加：

rust 复制代码

fn main() {
    println!("Hello from Rust!");
}

编译运行 ：
bash 复制代码
```
cargo run  # 自动编译并执行
```

五、进阶配置（可选）

1. 安装 WebAssembly 工具链

若需开发 WASM 应用（如与前端结合）：

bash 复制代码

rustup target add wasm32-unknown-unknown  # 添加 WASM 编译目标
cargo install wasm-pack                   # 安装 WASM 打包工具

2. 切换工具链版本

bash 复制代码

rustup default nightly   # 使用 nightly 版本（尝鲜新特性）
rustup update            # 更新到最新稳定版

六、常见问题解决

安装卡顿或失败：检查镜像配置，或临时关闭防火墙。
VS Code 插件不生效 ：重启编辑器，确保 rust-analyzer 已正确加载。
编译错误提示缺少链接器：确认 C++ 构建工具已安装，或切换为 MinGW 工具链。

七、学习资源推荐

官方教程 ：《Rust 程序设计语言》（适合系统学习）。
实战练习 ：Rustlings（小型练习巩固语法）。

通过以上步骤，你已搭建完整的 Rust 开发环境，可结合前端技术栈（如 WASM）探索高性能应用开发！