Rustup 安装指南：多种安装方式详解

Rustup 是 Rust 官方推荐的 Rust 工具链管理工具，它允许开发者轻松安装、管理和切换不同版本的 Rust 工具链。本文将详细介绍 Rustup 的各种安装方式，帮助开发者选择最适合自己环境的安装方法。

标准安装方式

Windows 平台安装

在 Windows 系统上安装 Rustup 需要：

1. 根据系统架构下载对应的安装程序：

   • x86_64 架构：x86_64-pc-windows-msvc
   • ARM64 架构：aarch64-pc-windows-msvc

2. 运行下载的 rustup-init.exe 安装程序

3. 确保已安装 Visual C++ Build Tools 2019 或 Visual Studio 2019（包含 C++ 工具）

安装时可以通过以下方式自定义默认工具链：

• 交互式选择
• 使用 --default-host 参数
• 安装后通过 rustup set default-host 命令修改

Unix 平台安装

在 Unix 类系统（Linux、macOS 等）上，只需在终端执行以下命令：

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

这条命令会：

1. 下载 rustup-init.sh 脚本
2. 执行脚本并自动下载适合当前平台的 rustup-init 可执行文件

安装参数配置

可以通过管道传递参数给安装脚本，实现自定义安装：

# 查看帮助信息
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --help

# 不修改 PATH 环境变量
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --no-modify-path

# 设置默认工具链为 nightly 版本
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --default-toolchain nightly

# 安装时不设置默认工具链
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --default-toolchain none

# 使用最小化安装配置并设置 nightly 为默认工具链
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --profile minimal --default-toolchain nightly

使用包管理器安装

通用建议

不同包管理器对 Rustup 的管理方式略有不同，安装后通常有两种情况：

1. 如果包管理器已提供 rustup 命令和 Rust 工具代理（如 rustc、cargo），只需设置默认工具链：

rustup default stable

2. 如果包管理器只提供 rustup-init 命令，运行：

rustup-init

这将完成初始设置，安装所有 Rustup 管理的工具代理，并安装默认工具链。

安装完成后，请确保 $HOME/.cargo/bin 已正确添加到 PATH 环境变量中。

APT 安装（Debian/Ubuntu）

从 Debian 13 (trixie) 和 Ubuntu 24.04 (noble) 开始，可以使用 apt 安装：

sudo apt install rustup

Homebrew 安装（macOS）

使用 Homebrew 安装：

brew install rustup

注意：此方式安装的 Rust 工具（如 rustc 和 cargo）默认不在 $PATH 中，可以手动添加：

export PATH="$(brew --prefix rustup)/bin:$PATH"

手动安装方式

可以从官方服务器手动下载适合您平台的 rustup-init 程序：

下载地址格式： https://static.rust-lang.org/rustup/dist/{目标平台三元组}/rustup-init[.exe]

例如：

• x86_64 Linux: x86_64-unknown-linux-gnu
• ARM64 macOS: aarch64-apple-darwin
• x86_64 Windows: x86_64-pc-windows-msvc

每个下载文件都附带 SHA-256 校验文件，可用于验证下载完整性。

Windows 平台注意事项

1. GNU 版本：基础使用无需额外软件，但编译某些库可能需要完整 MSYS2 和 MinGW 环境
2. MSVC 版本：需要安装 Visual Studio 2019 或 Visual C++ Build Tools 2019，并确保勾选 "C++ 工具" 和 "Windows 10 SDK"

从源码编译安装

高级用户可以从源码编译安装 Rustup：

1. 克隆 Rustup 源码仓库
2. 运行 cargo run --release 进行编译和安装

注意：安装后，Rustup 管理的工具链会通过修改 PATH 环境变量（添加 ~/.cargo/bin）来覆盖系统原有的 Rust 工具链。

总结

Rustup 提供了多种灵活的安装方式，开发者可以根据自己的需求和技术水平选择最适合的安装方法。无论选择哪种方式，安装完成后都应验证 rustup、rustc 和 cargo 命令是否可用，并确保 $HOME/.cargo/bin 在 PATH 环境变量中。