如何快速安装 Rustup：一站式 Rust 工具链管理指南 🚀

Rustup 是 Rust 编程语言的官方工具链安装器，能够帮助开发者轻松管理多个 Rust 版本、组件和目标平台。通过本指南，你将掌握如何在不同操作系统上快速配置 Rustup，开启高效 Rust 开发之旅。

📋 安装前的准备工作

系统要求

• 支持平台：Windows、macOS、Linux 全平台兼容
• 网络环境：需联网下载工具链（建议稳定网络）
• 权限要求：普通用户权限即可（无需管理员权限）

检查环境

• Windows 用户：无需预装任何依赖（安装程序会自动配置 MSVC 环境）
• Unix 系统：需确保已安装 curl 或 wget（通常系统自带）

💻 一键安装 Rustup 的详细步骤

1️⃣ 获取安装脚本

打开终端执行以下命令下载官方安装脚本：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

🌟 提示：如果系统没有 curl，可替换为 wget https://sh.rustup.rs -O rustup-init.sh && sh rustup-init.sh

2️⃣ 运行安装程序

脚本下载后会自动启动安装向导。Windows 用户可直接双击运行 rustup-init.exe。

Rustup 安装程序初始界面，展示版本信息和安装选项

3️⃣ 选择安装配置

安装程序提供三种选项：

• 默认安装（推荐新手）：自动配置稳定版工具链
• 自定义安装：可选择组件、安装路径和默认工具链
• 取消安装：退出安装流程

Rustup 安装配置选择界面，箭头指示默认选项

4️⃣ 完成组件配置

根据开发需求选择额外组件（如 rust-src 源码组件、clippy 代码检查工具）。Windows 用户需注意勾选 MSVC 构建工具。

Windows 系统 MSVC 组件安装选项界面

5️⃣ 验证安装结果

安装完成后，关闭当前终端并重新打开，执行以下命令验证：

rustc --version  # 查看 Rust 编译器版本
cargo --version  # 查看 Cargo 包管理器版本
rustup show      # 查看已安装工具链信息

Rustup 安装成功后的终端输出示例

⚙️ 常见配置与优化

切换 Rust 版本

rustup default stable       # 设置稳定版为默认
rustup toolchain install nightly  # 安装 nightly 版本
rustup override set nightly  # 为当前项目设置 nightly 版本

安装目标平台

如需交叉编译，可添加目标平台：

rustup target add wasm32-unknown-unknown  # 添加 WebAssembly 目标
rustup target list --installed  # 查看已安装目标

环境变量配置

Rustup 会自动配置环境变量，默认安装路径：

• Unix 系统：$HOME/.cargo/bin
• Windows 系统：%USERPROFILE%\.cargo\bin

📚 官方资源与帮助

• 用户手册：doc/user-guide/
• 开发指南：doc/dev-guide/
• 命令帮助：rustup help 或 rustup <命令> --help

❓ 常见问题解决

安装速度慢怎么办？

可使用国内镜像加速：

export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup

Windows 编译报错？

确保已安装 Visual Studio 构建工具：

1. 运行 rustup self update 更新 rustup
2. 执行 rustup component add msvc 安装 MSVC 组件

Windows SDK 组件选择界面，确保勾选 C++ 构建工具

通过以上步骤，你已成功配置 Rustup 工具链管理系统。现在可以开始编写第一个 Rust 程序了：cargo new hello-world && cd hello-world && cargo run，体验 Rust 的强大功能！ 🦀