如何用 rustup 更新 Rust 到最新 stable 版本?

文章导读
在已安装 rustup 的环境中,执行 rustup update stable 命令即可将 Rust 更新到最新稳定版。该操作适用于 Linux、macOS 及 Windows 系统,前提是 rustup 工具链管理器已正确配置环境变量。
📋 目录
  1. 命令速用版
  2. 为什么会这样
  3. 分步处理
  4. 怎么验证是否生效
  5. 常见坑
  6. 常见问题
  7. 参考来源
A A

在已安装 rustup 的环境中,执行 rustup update stable 命令即可将 Rust 更新到最新稳定版。该操作适用于 Linux、macOS 及 Windows 系统,前提是 rustup 工具链管理器已正确配置环境变量。

先说结论:使用 rustup 管理工具链时,一条命令即可完成稳定版更新,无需手动下载编译器。

  • 适合:已安装 rustup 且需要跟进官方稳定 releases 的开发者
  • 先看:执行前确认当前版本及项目依赖兼容性,避免构建断裂
  • 建议:更新后运行 cargo build 验证项目能否在新工具链下正常编译

命令速用版

若终端已识别 rustup 命令,直接运行以下两条指令即可完成更新与验证:

rustup update stable
rustc `--version`

若未安装 rustup,需先通过官方脚本初始化环境:

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

为什么会这样

rustup 是 Rust 官方推荐的工具链管理器,它抽象了编译器、包管理器和文档工具的版本关系。通过 channel 机制(stable/beta/nightly),rustup 能够隔离不同版本环境,避免全局冲突,因此更新操作只需针对工具链通道而非单独替换二进制文件。

分步处理

按以下顺序执行操作,确保环境状态可控:

  1. 确认当前版本:运行 rustc `--version` 记录更新前版本号,便于出现问题时回退。
  2. 执行更新命令:运行 rustup update stable,工具会自动同步远程仓库并下载最新稳定版组件。
  3. 加载环境变量:若刚安装 rustup 或遇到命令未找到错误,运行 source $HOME/.cargo/env 刷新终端会话。
  4. 重建项目依赖:进入项目目录执行 cargo build,确保新编译器与现有依赖兼容。

怎么验证是否生效

更新完成后,通过以下命令检查工具链版本信息:

如何用 rustup 更新 Rust 到最新 stable 版本?
  • 编译器版本:rustc `--version` 应显示最新稳定版版本号。
  • 包管理器版本:cargo `--version` 应显示对应版本且无报错。
  • 工具链列表:rustup toolchain list 应标记 stable 为当前默认或已安装状态。

若版本号未变化,检查网络连接或是否设置了错误的 rustup 镜像源。

常见坑

  • 网络下载失败:国内用户若遇到 downloading component 卡住,可配置清华镜像源 export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup。
  • 环境变量失效:手动修改过 PATH 可能导致命令无法识别,需确保 $HOME/.cargo/bin 在路径中。
  • 项目编译报错:新版本 Rust 可能废弃旧语法,升级前建议备份重要项目代码及配置文件。
  • 权限问题:Linux/macOS 下无需 sudo 执行 rustup 命令,默认安装于用户目录,使用 sudo 可能导致权限混乱。

常见问题

没有安装 rustup 可以直接更新吗?

不可以,必须先安装 rustup 才能管理版本。未安装时需运行 curl 官方脚本初始化环境,安装完成后才能使用 update 命令。

如何切换到特定版本而不是最新版?

使用 rustup install 1.75.0 安装指定版本,再通过 rustup default 1.75.0 设置为全局默认版本。

更新后 cargo 命令无法使用怎么办?

通常是环境变量未生效,关闭终端重新打开或手动执行 source $HOME/.cargo/env 即可恢复。

nightly 版本如何更新?

将 stable 替换为 nightly 即可,运行 rustup update nightly 可更新夜间构建版本。

参考来源

  • Ubuntu 下 Rust 版本如何升级
  • centos 系统 rust 版本如何升级
  • 怎么利用 Rustup 在 MacOS 中安装 Rust 工具链与更新实战
  • Rust 环境准备 - 持续更新
  • CentOS 系统如何更新 Rust 到最新版本
  • Linux 系统中 Rust 的版本管理怎么做
  • Linux 系统中如何更新 Rust 版本
  • Rust 安装与版本切换:基于 rustup 的生态化版本管理实践
  • Rust 版本冲突终极解决方案:一键切换稳定版、测试版与 Nightly 版
  • 安装与切换 Rust 版本