用 rustup 安装工具链并切换默认工具链

准备工作

• macOS/Linux 终端；网络可访问 rustup 安装源或你们内网镜像。

• 依据：rustup 官方文档（The rustup book）。[1]

• 核实日期：2026-10-24。

操作步骤

1、安装 rustup

做什么：打开 https://rustup.rs/ ，按其当前页展示的安装命令执行；或使用发行版包装的 rustup 包。安装程序会写入 rustc/cargo/rustup 并提示配置 PATH。

为什么：rustup 是官方推荐的工具链管理器，可并行安装 stable/beta/nightly，并按目录覆盖默认通道，比“只装一个发行版包”更适合多项目。[1]

怎么确认：新开终端后 rustc --version、cargo --version、rustup --version 均有输出；rustup show 能打印默认工具链与已安装组件。

2、设置默认工具链为 stable

做什么：

rustup default stable
rustup update

为什么：明确默认通道，避免新开终端落到过期 nightly；update 拉取该通道最新补丁。[1]

怎么确认：rustup show 中 active/default 为 stable；rustc -Vv 的 release 字段匹配 stable。

3、按项目覆盖工具链（可选）

做什么：在需要 nightly 的项目目录执行：

rustup override set nightly

为什么：个别 crate 或示例依赖 nightly 特性，又不想把全局默认改成 nightly。目录覆盖只影响该路径及其子路径。[1]

怎么确认：该目录下 rustc -Vv 显示 nightly；切到其他目录后仍是 stable；可用 rustup override list 查看覆盖表。

4、安装常用组件（可选）

做什么：rustup component add clippy rustfmt

为什么：格式化与静态检查是日常开发常见组件；通过 rustup 安装与工具链版本对齐。[1]

怎么确认：cargo fmt --version、cargo clippy -V 有输出。

Rust 的发布通道（stable/beta/nightly）和“某一天的工具链快照”是两层概念。rustup 让你在同一台机器上并行保留多套，并按目录覆盖，这在跟进实验特性或给旧项目锁旧版本时很实用。

装好后先确认 IDE、终端、CI 用的是同一条 rustc 路径，否则会出现“命令行能编译、编辑器红线一片”的错觉。which rustc 与 IDE 设置里的 toolchain 路径对照一下，能省很多时间。

若公司有内部 crates 源，把镜像与 token 放在用户级配置，不要写进项目仓库。工具链可以共享，凭证必须按人、按机隔离。

第一次安装后若命令找不到，多半是当前 shell 还没加载 rustup 写入的 PATH；重开终端或按安装结束时的提示 source 环境脚本即可。

注意事项

• 企业网络若拦截 curl | sh，改用官方安装包、校验和或内部镜像。

• 不要把含 registry token 的环境脚本提交进 Git。

• 卸载或切换工具链前，先确认 IDE 使用的是哪一个 rustc 路径。

来源

[1] rustup book · https://rust-lang.github.io/rustup/ · 核实于 2026-10-24

#Rust #rustup #工具链 #教程 #cargo