Rustup 安装与版本管理
什么是 Rustup
Rustup 是 Rust 官方提供的工具链安装器和版本管理器。你可以把它理解为 Node.js 的 nvm 或 Python 的 pyenv——它负责下载、安装、切换不同版本的 Rust 编译器和相关工具。无论你用的是 Windows、macOS 还是 Linux,Rustup 都是安装 Rust 的推荐方式。
不要通过系统包管理器(比如 apt、brew)直接安装 Rust,因为那些源里的版本通常严重滞后于官方发布。Rustup 能让你随时用上最新的稳定版,也能方便地切换到 nightly 或 beta 版本。
在 Windows 上安装
Windows 用户需要先确保安装了 MSVC 构建工具(Visual Studio Build Tools),然后下载 Rustup 安装程序。
第一步,安装 Visual Studio Build Tools。访问 https://visualstudio.microsoft.com/visual-cpp-build-tools/ 下载安装器,勾选"使用 C++ 的桌面开发"工作负载。这一步是必须的,因为 Rust 在 Windows 上默认使用 MSVC 链接器来编译程序。
第二步,下载并运行 Rustup 安装程序。访问 https://rustup.rs/ 下载 rustup-init.exe,运行后按照提示操作即可。
在 PowerShell 中验证安装:
# 查看 Rust 编译器版本
rustc --version
# 输出类似:rustc 1.94.0 (e2014e876 2026-03-17)
# 查看 Cargo 版本
cargo --version
# 输出类似:cargo 1.94.0 (4dbedd700 2026-03-12)
# 查看 Rustup 版本
rustup --version
# 输出类似:rustup 1.28.2 (2025-04-02)在 macOS / Linux 上安装
打开终端,运行官方安装脚本:
# 下载并运行 Rustup 安装脚本
# --proto '=https' 强制使用 HTTPS 协议
# --tlsv1.2 指定最低 TLS 版本
# -sSf 表示静默模式但显示错误
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh安装脚本会提示你选择安装方式,直接按回车选默认选项就好。安装完成后,需要让环境变量生效:
# 让当前终端加载 Rust 环境变量
# 安装脚本会把路径写入 ~/.cargo/env
source "$HOME/.cargo/env"如果你用的是 zsh(macOS 默认 shell),也可以把下面这行加到 ~/.zshrc 里,这样以后每次开终端都会自动加载:
# 在 ~/.zshrc 末尾添加
. "$HOME/.cargo/env"工具链的三个发布通道
Rust 有三个发布通道,每个通道对应不同的稳定程度:
| 通道 | 更新频率 | 稳定性 | 适用场景 |
|---|---|---|---|
| stable | 每 6 周发布一次 | 最高,所有特性经过充分测试 | 生产环境、日常开发 |
| beta | 每 6 周发布一次 | 较高,是下一个 stable 的候选版 | 提前测试兼容性 |
| nightly | 每天发布 | 最低,包含实验性特性 | 使用不稳定特性、参与 Rust 开发 |
绝大多数情况下,用 stable 通道就够了。只有当你需要用到某个还没稳定的语言特性(比如某些 nightly-only 的宏或编译器选项)时,才需要切到 nightly。
版本管理常用命令
# 查看当前正在使用的工具链信息
# 会显示默认工具链、已安装的工具链列表、当前激活的工具链
rustup show
# 更新所有已安装的工具链到最新版本
rustup update
# 只更新 stable 通道
rustup update stable
# 安装 nightly 工具链
rustup toolchain install nightly
# 安装指定版本的工具链
rustup toolchain install 1.80.0
# 列出所有已安装的工具链
rustup toolchain list
# 设置默认工具链为 stable
rustup default stable
# 设置默认工具链为 nightly
rustup default nightly
# 卸载某个工具链
rustup toolchain uninstall nightly为单个项目指定工具链
有时候不同项目需要用不同版本的 Rust。Rustup 提供了两种方式来实现这一点。
方式一:使用 rustup override 命令为当前目录设置工具链覆盖:
# 进入项目目录后执行
# 这会为当前目录及其子目录设置工具链覆盖
rustup override set nightly
# 查看当前所有的目录覆盖设置
rustup override list
# 取消当前目录的覆盖
rustup override unset方式二:在项目根目录创建 rust-toolchain.toml 文件(推荐,因为可以提交到版本控制):
# rust-toolchain.toml
# 这个文件放在项目根目录,Rustup 会自动识别
[toolchain]
# 指定使用 stable 通道
channel = "stable"
# 也可以指定具体版本:channel = "1.94.0"
# 或者 nightly:channel = "nightly"这种方式的好处是团队所有成员和 CI 环境都会自动使用相同版本的 Rust,不需要每个人手动设置。
安装额外组件
Rustup 除了安装编译器,还能安装 Rust 生态中的各种工具组件。
# 安装代码格式化工具
rustup component add rustfmt
# 安装 Lint 工具
rustup component add clippy
# 安装 Rust 源码(IDE 跳转定义时需要)
rustup component add rust-src
# 安装语言服务器(配合 VS Code 等编辑器使用)
rustup component add rust-analyzer
# 查看当前工具链已安装的组件
rustup component list --installed
# 查看所有可用的组件
rustup component list安装交叉编译目标
如果你需要为其他平台编译程序(比如在 Windows 上编译 Linux 的可执行文件),需要安装对应的编译目标。
# 查看所有可用的编译目标
rustup target list
# 安装 Linux x86_64 目标(在 Windows 上交叉编译 Linux 程序时需要)
rustup target add x86_64-unknown-linux-gnu
# 安装 WebAssembly 目标(编译 WASM 时需要)
rustup target add wasm32-unknown-unknown
# 查看已安装的目标
rustup target list --installed更新与自我维护
# 更新 Rustup 自身
rustup self update
# 更新所有工具链和组件
rustup update
# 如果需要完全卸载 Rust 和 Rustup
rustup self uninstall基本示例
下面是一个从零开始的完整安装和验证流程(Windows PowerShell 环境):
# 第一步:下载并运行 rustup-init.exe(从 https://rustup.rs/)
# 按照提示完成安装
# 第二步:关闭并重新打开 PowerShell,验证安装
rustc --version
cargo --version
# 第三步:创建一个测试项目验证工具链是否正常工作
cargo new hello-rust
# 第四步:编译并运行
cd hello-rust
cargo run
# 应该看到输出:Hello, world!
# 第五步:安装常用组件
rustup component add rustfmt clippy rust-analyzer
# 第六步:查看当前安装状态
rustup show常见问题
问题一:安装过程中提示网络超时怎么办?
国内访问 Rust 官方服务器可能比较慢。可以在安装前设置镜像源环境变量,详见"国内镜像源配置"章节。在 PowerShell 中临时设置:
# 设置清华镜像源
$ENV:RUSTUP_DIST_SERVER = 'https://mirrors.tuna.tsinghua.edu.cn/rustup'
$ENV:RUSTUP_UPDATE_ROOT = 'https://mirrors.tuna.tsinghua.edu.cn/rustup/rustup'
# 然后运行安装程序
.\rustup-init.exe问题二:rustc 命令找不到怎么办?
说明环境变量没有正确配置。Rustup 会把工具安装到 ~/.cargo/bin 目录。检查这个目录是否在系统的 PATH 中。Windows 上重新运行安装程序通常可以修复。Linux/macOS 上执行 source "$HOME/.cargo/env"。
问题三:stable 和 nightly 可以同时安装吗?
可以。Rustup 支持同时安装多个工具链,它们互不影响。用 rustup default 设置全局默认的工具链,用 rustup override 或 rust-toolchain.toml 为特定项目指定工具链。
问题四:rustup update 和 rustup self update 有什么区别?
| 命令 | 更新内容 | 执行频率建议 |
|---|---|---|
rustup update | 更新已安装的所有 Rust 工具链(stable、nightly 等) | 每隔几周执行一次 |
rustup self update | 更新 Rustup 工具本身 | 偶尔执行即可 |
适用场景
- 初次安装 Rust 开发环境:Rustup 是唯一推荐的安装方式
- 团队协作统一 Rust 版本:通过
rust-toolchain.toml文件锁定版本 - 尝试 nightly 特性:安装 nightly 工具链,在需要的项目中切换使用
- 交叉编译:安装不同平台的编译目标
- CI/CD 环境配置:在持续集成流水线中用 Rustup 安装指定版本的 Rust
注意事项
- 不要用系统包管理器(apt、brew、choco 等)安装 Rust,版本会滞后很多,而且和 Rustup 安装的 Rust 可能冲突
- Windows 上必须先安装 MSVC 构建工具,否则编译会失败
rustup update只会更新工具链,不会自动更新你项目的Cargo.lock文件- nightly 版本每天都不一样,某一天的 nightly 可能因为编译器 bug 而编译失败,这是正常的
rust-toolchain.toml文件应该提交到 Git 仓库,这样团队所有人自动使用相同版本- 安装新组件后如果报"组件不可用",通常是因为当天的 nightly 还没编译好该组件,换一天再试或用
rustup toolchain install nightly --component rust-src指定组件安装
总结
Rustup 是管理 Rust 工具链的核心工具,负责安装、更新和切换不同版本的 Rust 编译器及其配套工具。它支持 stable、beta、nightly 三个发布通道,允许你同时安装多个版本并按项目切换。日常开发中,用 rustup update 保持工具链最新,用 rust-toolchain.toml 文件为项目锁定版本,用 rustup component add 安装 rustfmt、clippy 等工具组件。掌握 Rustup 的使用是搭建 Rust 开发环境的第一步,也是后续所有开发工作的基础。