【AI说Rust 02】如何在 windows11 系统搭建 Rust 开发环境

在 Windows 11 上搭建 Rust 开发环境是一个直接的过程，核心是安装 Rust 工具链并配置一个舒适的开发环境。下面我为你梳理了一份详细的步骤指南和后续学习建议。

🛠️ 安装 Rust 工具链

Rust 是通过一个叫做 rustup 工具来安装和管理的。请按照以下步骤操作：

1. 安装必要的编译环境
   在 Windows 上，Rust 需要 C/C++ 编译环境来链接代码。最简单的是安装 Microsoft C++ 生成工具。访问 Visual Studio 官网，下载并运行生成工具安装器。在安装时，确保勾选用于 C++ 开发的必要组件。

2. 下载并运行 Rust 安装器
   访问 Rust 官方网站的 https://rustup.rs/ 或 https://www.rust-lang.org/tools/install 下载 rustup-init.exe。

3. 运行安装并接受默认选项
   双击运行 rustup-init.exe。它会提示你进行选择，对于大多数用户来说，直接按回车键使用默认安装是最简单可靠的方式。安装程序会下载并安装最新的稳定版 Rust、包管理器 Cargo 和 rustup 本身。

4. （可选但推荐）配置国内镜像加速
   如果你在国内，可能会觉得下载速度较慢。在运行安装程序之前，可以先设置环境变量，使用国内的镜像源来显著提升下载速度。
   在命令行（如 PowerShell）中临时设置，或将其添加到系统的环境变量中：

   # 在 PowerShell 中执行以下命令
   $env:RUSTUP_DIST_SERVER="https://mirrors.ustc.edu.cn/rust-static"
   $env:RUSTUP_UPDATE_ROOT="https://mirrors.ustc.edu.cn/rust-static/rustup"
   

   或者使用阿里云等其它镜像。

5. 验证安装
   安装完成后，务必重新启动命令行终端（如 PowerShell 或 CMD），然后执行以下命令来验证安装是否成功：

   rustc --version
   cargo --version
   

   如果每条命令都正确输出了版本号，恭喜你，Rust 工具链已经安装成功。

🔧 配置开发环境与包管理

1. （可选）配置 Cargo 国内镜像
   不仅工具链下载可以加速，后续下载项目依赖的库（crate）时也可以配置国内镜像。在 Cargo 的主目录（通常是 %USERPROFILE%\.cargo）下创建一个名为 config.toml 的文件，并添加如下内容（以阿里云镜像为例）：

   [source.crates-io]
   replace-with = 'aliyun'[source.aliyun]
   registry = "sparse+https://mirrors.aliyun.com/crates.io-index/"
   

2. 了解基本 Cargo 命令
   Cargo 是 Rust 的构建系统和包管理器，非常重要。

   • cargo new project_name: 创建一个新的 Rust 项目。
   • cargo build: 编译项目。
   • cargo run: 编译并运行项目。
   • cargo check: 快速检查代码是否能通过编译，而不生成可执行文件。
   • 对于常用命令，Cargo 还提供了简写，例如 cargo b 对应 build，cargo r 对应 run，cargo t 对应 test。

💻 选择代码编辑器或 IDE

虽然可以用任何文本编辑器编写代码，但一个功能强大的编辑器能极大提升效率。

• 强烈推荐：Visual Studio Code (VS Code)。它免费、轻量且插件生态丰富。安装 VS Code 后，务必安装 rust-analyzer 插件，它是官方推荐的 Rust 语言服务器，能提供卓越的代码补全、跳转和错误提示功能。此外，还可以考虑安装 CodeLLDB 插件以支持调试。
• 其他选择：如果你习惯 JetBrains 家族的 IDE（如 IntelliJ IDEA、CLion），可以安装 RustRover 或 Rust 插件，它们也提供强大的功能。

🚀 创建你的第一个 Rust 项目

现在，让我们用 Cargo 创建一个新项目并运行它，来测试整个环境：

1. 打开终端（如 PowerShell），导航到你希望创建项目的目录。
2. 执行以下命令：

   cargo new hello_world
   cd hello_world
   cargo run
   

   如果一切顺利，你将在终端看到输出：Hello, world!。

⚠️ 可能遇到的问题与解决思路

• 命令未找到 (rustc/cargo is not recognized)：这通常是因为安装后没有重启终端，或者 Cargo 的 bin 目录（通常是 %USERPROFILE%\.cargo\bin）没有正确添加到系统的 PATH 环境变量中。请重启终端试试，如果还不行，检查环境变量设置。
• 编译时链接错误：如果你在安装过程中选择了非默认的 GNU 工具链（如 x86_64-pc-windows-gnu），可能会遇到与 MinGW 相关的链接错误。对于大多数 Windows 用户，坚持使用默认的 MSVC 工具链通常是最稳妥的选择。
• 中文显示乱码：如果程序输出中文出现乱码，可以尝试将 Windows 系统的区域设置中的 Beta 版 Unicode UTF-8 全球语言支持勾选上，然后重启系统。

📚 后续学习资源

环境搭好了，接下来就是学习了：

• 《Rust 程序设计语言》（"The Book"）：是官方的权威入门教程，中文版可在 KaiserY 的 GitHub Pages 上找到。
• Rustlings：一个交互式的系列小练习，通过修复代码错误来学习 Rust 语法和概念，非常适合初学者巩固知识。
• Cargo 手册：熟练掌握 Cargo 是高效使用 Rust 的关键。

希望这份指南能帮助你顺利开启 Rust 编程之旅！如果你在安装过程中遇到更具体的问题，或者想了解某个学习要点的细节，随时可以再问我。