Windows 10 配置 WSL2 + Rust 开发环境完整指南
本教程将指导您在 Windows 10 上完整配置 WSL2 和 Rust 开发环境，让您能够在 Windows 系统上享受 Linux 开发体验。
📋 环境要求
- Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）
- 管理员权限
- 稳定的网络连接
🚀 快速开始
步骤概览
- 安装 WSL2 - 启用 Windows 子系统功能
- 安装 Rust - 在 WSL2 中安装 Rust 工具链
- 安装 GCC - 配置 C 语言编译环境
- 配置 VSCode - 安装 Remote-WSL 扩展
- 安装 Rust 插件 - 配置 rust-analyzer
- 验证环境 - 创建测试项目验证配置
1️⃣ 安装 WSL2
检查 Windows 版本
首先确认您的 Windows 版本是否支持 WSL2：
- 按
Win + R打开运行对话框 - 输入
winver并回车 - 确认版本为 Windows 10 版本 2004 或更高
系统要求
确保您的系统满足以下条件：
安装步骤
参考官方文档：安装 WSL
快速安装命令（以管理员身份运行 PowerShell）：
wsl --install
2️⃣ 在 WSL2 中安装 Rust
安装 Rust 工具链
在 WSL2 终端中运行以下命令：
# 下载并安装 Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# 安装过程中按回车接受默认配置
# 安装完成后重新加载环境变量
source ~/.cargo/env
验证安装
检查 Rust 是否正确安装：
cargo --version
rustc --version
预期输出示例：
cargo 1.70.0 (ec8a8a0ca 2023-04-25)
rustc 1.70.0 (90c541806 2023-05-31)
3️⃣ 安装 GCC 编译环境
Rust 需要 C 语言编译环境来构建原生依赖。
更新包管理器并安装 GCC
# 更新包列表
sudo apt update
# 安装 GCC 和必要的构建工具
sudo apt install -y gcc build-essential
# 验证安装
gcc --version
为什么需要 GCC？
- Rust 的某些 crate 包含 C/C++ 代码
- 需要 C 编译器来构建这些原生依赖
- 提供链接器支持
4️⃣ 配置 VSCode Remote-WSL
安装 Remote-WSL 扩展
- 打开 VSCode
- 进入扩展市场（Ctrl+Shift+X）
- 搜索 "Remote - WSL"
- 安装 Microsoft 官方的 Remote-WSL 扩展
连接到 WSL2
- 按
Ctrl+Shift+P打开命令面板 - 输入 "WSL: Connect to WSL"
- 选择您的 WSL2 发行版
打开项目文件夹
首次连接需要等待初始化完成，然后：
- 点击 "Open Folder"
- 选择 WSL2 中的项目目录
- 点击 "OK" 确认
连接成功后，VSCode 的终端将直接连接到 WSL2 环境：
5️⃣ 安装 Rust 开发插件
安装 rust-analyzer
- 在 VSCode 扩展市场中搜索 "rust-analyzer"
- 安装 rust-analyzer 扩展（推荐使用官方版本）
- 重启 VSCode 以确保扩展正常工作
rust-analyzer 功能：
- 代码补全和智能提示
- 错误检查和诊断
- 代码格式化
- 重构支持
- 跳转到定义
6️⃣ 验证开发环境
创建测试项目
# 创建新的 Rust 项目
cargo new hello-world
cd hello-world
# 运行项目
cargo run
编写示例代码
编辑 src/main.rs 文件：
// 定义用户结构体
struct User {
name: String,
}
impl User {
// 静态方法
fn hello() {
println!("Hello, World!");
}
// 实例方法
fn say(&self) {
println!("Hello, {}!", self.name);
}
}
fn main() {
// 创建用户实例
let user = User {
name: String::from("Rust Developer"),
};
// 调用静态方法
User::hello();
// 调用实例方法
user.say();
}
运行和验证
cargo run
预期输出：
Hello, World!
Hello, Rust Developer!
开发体验演示
🔧 常见问题解决
WSL2 启动失败
# 重启 WSL2 服务
wsl --shutdown
wsl
Rust 安装失败
# 设置代理（如果需要）
export https_proxy=http://your-proxy:port
export http_proxy=http://your-proxy:port
# 重新安装
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
VSCode 连接失败
- 确保 WSL2 正在运行
- 重启 VSCode
- 重新安装 Remote-WSL 扩展
编译错误
# 更新 Rust 工具链
rustup update
# 清理并重新构建
cargo clean
cargo build
📚 参考资源
🎉 总结
恭喜！您已经成功配置了 Windows 10 + WSL2 + Rust 开发环境。现在您可以：
- ✅ 在 Windows 上享受 Linux 开发体验
- ✅ 使用 VSCode 进行 Rust 开发
- ✅ 享受完整的 Rust 工具链支持
- ✅ 在 WSL2 中运行和调试 Rust 程序
开始您的 Rust 开发之旅吧！🚀
