---

Rust开发必备：rustup安装与使用指南

引言：为何选择 Rust？为何需要 rustup？

近年来，Rust 作为一种强调内存安全、并发性和性能的系统级编程语言，受到了开发者社区的广泛关注和喜爱。它被 Stack Overflow 开发者调查连续多年评选为“最受喜爱的编程语言”，并在操作系统、WebAssembly、命令行工具、网络服务等多个领域展现出强大的能力。

对于初学者或希望深入 Rust 世界的开发者来说，搭建一个稳定、灵活且功能齐全的开发环境是迈出第一步的关键。与其他语言不同，Rust 的工具链（包括编译器 rustc、包管理器 cargo、标准库以及各种辅助工具）发布得非常频繁（每六周发布一个新稳定版，并有 beta 和 nightly 版本），而且 Rust 生态系统支持多种目标平台（Target）。如何在众多版本和目标平台之间进行管理和切换？这就引出了我们今天的主角—— rustup。

rustup 是 Rust 官方推荐的工具链安装与管理工具。它解决了以下核心问题：

1. 便捷安装： 无论在 Windows、macOS 还是 Linux 上，rustup 提供了一致且简单的安装流程，让你快速获得 Rust 开发环境。
2. 多版本管理： 你可以轻松安装和切换不同的 Rust 版本（stable, beta, nightly）以及特定历史版本。这对于测试新特性、兼容旧项目或使用仍在 nightly 阶段的功能至关重要。
3. 多目标平台支持： Rust 强大的跨平台编译能力依赖于目标平台的支持。rustup 让你方便地添加和管理针对不同 CPU 架构和操作系统的编译目标（Target），实现交叉编译。
4. 组件管理： Rust 生态中有许多官方维护的辅助工具，如代码格式化工具 rustfmt、静态分析工具 clippy、文档生成工具 rustdoc 等。rustup 使得这些工具的安装和更新变得轻而易举。
5. 项目级隔离： rustup 允许你为特定的项目目录指定使用哪个 Rust 工具链版本，确保项目的构建环境稳定，不受全局设置影响。

简而言之，rustup 是 Rust 开发环境的基石，是每一个 Rust 开发者必备的利器。理解和掌握 rustup 的使用，将极大地提升你的 Rust 开发效率和体验。

本文将详细介绍 rustup 的安装过程、核心概念、常用命令以及一些进阶用法和故障排除技巧，助你开启或优化你的 Rust 开发之旅。

第一部分：安装 rustup

rustup 的安装过程在不同操作系统上略有差异，但都非常简单。核心思想是先下载并运行一个小的安装程序 rustup-init，它会引导你完成后续设置。

1. 在 macOS 和 Linux 上安装

在 macOS 和 Linux 系统上，推荐使用官方提供的 Shell 脚本进行安装。打开你的终端，然后执行以下命令：

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

这条命令做了几件事：
* curl --proto '=https' --tlsv1.2 -sSF https://sh.rustup.rs: 使用 curl 命令从 sh.rustup.rs 地址下载安装脚本。--proto '=https' --tlsv1.2 确保使用安全的 HTTPS 协议和 TLSv1.2 或更高版本，提高安全性；-sSF 使 curl 静默模式运行（不显示进度条），如果遇到错误则退出。
* | sh: 将下载的脚本内容通过管道传递给 sh 命令执行。

运行脚本后，你将看到类似以下的交互式提示：

“`
welcome to rust!

This will download and install the official compiler for the Rust programming
language, and its package manager, Cargo.

It will add the cargo, rustc, rustup commands to
this computer’s PATH.

You can uninstall at any time with rustup self uninstall and
these changes at any time by editing your .bashrc/.zshenv/.profile file.

To get started you need Cargo’s bin directory ($HOME/.cargo/bin) in your PATH
environment variable. Next time you log in this will be done automatically by
… (shell configuration file path) …

If you are running a login shell, you might need to reload your profile
or restart your terminal session to pick up the PATH changes.

1) Proceed with installation (default)
2) Customize installation
3) Cancel installation

“`

这里通常有三个选项：

• 1) Proceed with installation (default): 这是最常见的选项。它会安装默认的工具链（通常是最新的 stable 版本），并包含常用的组件。它还会尝试修改你的 Shell 配置文件（如 .bashrc, .zshenv, .profile 等），将 ~/.cargo/bin 目录添加到系统的 PATH 环境变量中。强烈推荐选择此项，除非你有特殊需求。
• 2) Customize installation: 允许你自定义安装的工具链、目标平台和组件等。对于初次安装，通常不需要选择此项。
• 3) Cancel installation: 取消安装。

输入 1 并按回车，或者直接按回车选择默认选项即可开始安装。安装程序会自动下载所需的 Rust 工具链文件，并将其安装到 ~/.rustup 目录中，并将 cargo、rustc 和 rustup 等可执行文件放置在 ~/.cargo/bin 目录。

安装完成后，脚本会提示你 PATH 环境变量已更新。为了让系统立即识别 cargo、rustc 等命令，你需要重新加载你的 Shell 配置文件，或者关闭并重新打开终端窗口。

重新加载配置文件的命令通常是：

bash
source ~/.bashrc # 如果你使用的是 Bash shell
source ~/.zshenv # 如果你使用的是 Zsh shell
source ~/.profile # 如果你使用的是其他 shell 或通用配置

验证安装：

重新打开终端或加载配置文件后，运行以下命令验证 Rust 和 Cargo 是否安装成功：

bash
rustc --version
cargo --version
rustup --version

如果这些命令都能正确显示版本信息，说明 rustup 和默认的 Rust 工具链已成功安装并配置到 PATH。

2. 在 Windows 上安装

在 Windows 上，安装过程更加直观，主要通过一个图形界面或命令行的安装程序 rustup-init.exe 完成。

1. 下载安装程序： 访问 Rust 官方安装页面 https://www.rust-lang.org/tools/install。网站会根据你的操作系统提供相应的下载链接。找到 Windows 版本的 rustup-init.exe 并下载。
2. 运行安装程序： 找到下载的 rustup-init.exe 文件，双击运行。

3. 安装向导： 你会看到一个命令行窗口或图形界面向导，内容与 macOS/Linux 的 Shell 脚本类似。它会询问你安装类型：

   • 1) Proceed with installation (default): 推荐选择此项。它会安装默认的 stable 工具链，并配置系统的 PATH 环境变量。
   • 2) Customize installation: 允许自定义安装。
   • 3) Cancel installation: 取消安装。

   通常输入 1 并回车即可。

4. 配置 PATH： 安装程序会自动将 Rust 的 bin 目录（通常是 %USERPROFILE%\.cargo\bin）添加到你的用户 PATH 环境变量中。这通常不需要手动操作。

5. 完成安装： 安装程序下载并安装完工具链后，会提示安装成功。你可能需要关闭并重新打开命令提示符（cmd）或 PowerShell 窗口，以便 PATH 环境变量的更改生效。

验证安装：

重新打开命令提示符或 PowerShell，运行以下命令：

powershell
rustc --version
cargo --version
rustup --version

如果能看到版本信息，则安装成功。

重要提示：
* 在 Windows 上，Rust 默认使用 MSVC（Microsoft Visual C++）工具链作为后端。你需要安装 Microsoft Visual C++ Build Tools 或 Visual Studio 来获取必要的链接器等组件。最简单的方式是安装 Visual Studio Community Edition 并勾选 “Desktop development with C++” 工作负载，或者只安装 Build Tools for Visual Studio 并勾选 “C++ build tools” 和所需的 Windows SDK。
* 如果你不想安装 MSVC 工具链，rustup 也支持安装 GNU 工具链（需要 MinGW）。但官方推荐并默认使用 MSVC。

3. 其他安装方式 (不推荐作为主要方式)

• 包管理器： 某些 Linux 发行版或 macOS (使用 Homebrew) 可能在其软件仓库中提供了 rustc 和 cargo。但通过包管理器安装的 Rust 版本可能不是最新的，并且通常不包含 rustup，这会让你无法方便地管理多个工具链和组件。因此，强烈推荐使用 rustup 官方方法安装。
• 离线安装： rustup 支持离线安装，但过程相对复杂，需要提前下载好安装文件。这适用于没有网络连接或网络受限的环境，本文不做详细介绍，但你知道它存在即可。

至此，你已经成功安装了 rustup 和默认的 Rust 工具链，为后续的开发打下了基础。

第二部分：rustup 核心概念

在使用 rustup 管理工具链之前，理解几个核心概念非常重要：

1. 工具链 (Toolchain):
   一个工具链是指特定 发布版本 (如 stable, beta, nightly 或特定版本号如 1.60.0) 的 Rust 编译器 (rustc)、包管理器 (cargo)、标准库以及一些捆绑的官方工具的集合，并且是针对特定的 目标平台 编译和打包的。

   • 发布通道 (Release Channels):
     • stable: 最稳定、推荐用于绝大多数生产环境的版本。每六周发布一次新版本。
     • beta: 测试版本，包含下一个 stable 版本将包含的功能。每六周发布一次新版本，在 stable 发布前六周进入 beta 阶段。
     • nightly: 每晚自动构建的版本，包含最新的、可能尚未完全稳定的功能。如果你想尝试最新的 Rust 特性或某些只能在 nightly 使用的功能（称为“不稳定特性”，unstable features），可以使用它。
   • 版本号: 你也可以安装特定的历史版本，例如 1.60.0。
   • 目标平台 (Target): 工具链通常与一个特定的目标平台绑定，例如 x86_64-unknown-linux-gnu (64位 Linux) 或 x86_64-apple-darwin (64位 macOS)。完整的工具链名称通常是 通道名-目标平台 或 版本号-目标平台，例如 stable-x86_64-unknown-linux-gnu。当你不指定目标平台时，rustup 通常会为你安装针对你当前操作系统的默认目标平台的工具链。

2. 目标平台 (Target):
   指你的 Rust 代码将要编译运行的 CPU 架构和操作系统组合。例如：

   • x86_64-unknown-linux-gnu: 64位 Linux
   • x86_64-apple-darwin: 64位 macOS
   • x86_64-pc-windows-msvc: 64位 Windows 使用 MSVC 工具链
   • aarch64-unknown-linux-gnu: 64位 ARM Linux
   • wasm32-unknown-unknown: WebAssembly (独立环境)
     rustup 允许你为一个已安装的工具链添加对额外目标平台的 标准库支持。这意味着你可以使用当前工具链编译出运行在其他平台上的二进制文件（交叉编译），而不需要为每个目标平台都安装完整的工具链副本。

3. 组件 (Component):
   指 Rust 官方提供的一些额外工具或标准库的特定部分。它们可以添加到某个或所有已安装的工具链中。常见的组件包括：

   • rustfmt: 代码格式化工具。
   • clippy: 强大的 Rust 代码 Linter，帮助发现潜在的问题和代码风格问题。
   • rust-docs: 标准库和工具链的本地文档副本。
   • rust-std: 针对特定目标平台的标准库。当你使用 rustup target add 命令时，实际上就是为当前的工具链添加了针对该目标的 rust-std 组件。
   • rls / rust-analyzer: Language Server，用于提供 IDE 支持（代码补全、跳转、诊断等）。rust-analyzer 是 RLS 的继任者，目前更常用。
   • src: 标准库源码。

4. 默认工具链 (Default Toolchain):
   当你直接运行 rustc 或 cargo 命令而没有额外指定工具链时，rustup 会使用配置为“默认”的那个工具链。初次安装时，通常最新的 stable 工具链会被设置为默认。

5. 工具链覆盖 (Toolchain Overrides):
   rustup 最实用的功能之一。它允许你指定一个特定的目录（通常是一个项目根目录）及其子目录应该使用哪个 Rust 工具链版本，而不是使用全局的默认工具链。这通过在项目根目录创建一个 .rustup-toolchain 文件或使用 rustup override set 命令实现。当你在一个设置了覆盖的目录中运行 rustc 或 cargo 时，rustup 会优先使用该目录指定的工具链。这对于在不同项目中使用不同 Rust 版本非常方便。

理解了这些概念后，我们就可以开始学习如何使用 rustup 的命令来管理它们了。

第三部分：rustup 常用命令详解

掌握 rustup 的常用命令是高效管理 Rust 环境的关键。以下是主要的命令及其用法：

1. 查看当前状态 (rustup show)

这是最常用的命令之一，用于查看当前 Rust 环境的概览：

bash
rustup show

输出示例：

“`
Default host: x86_64-unknown-linux-gnu
rustup home: /home/yourusername/.rustup

stable-x86_64-unknown-linux-gnu (default)
rustc 1.70.0 (90c541806 2023-05-31)
“`

解释：
* Default host: rustup 本身运行的平台。
* rustup home: rustup 安装文件、工具链、组件等存放的目录。
* 下一行显示了当前正在使用的工具链。括号中的 (default) 表示它是全局默认工具链。
* rustc 版本信息显示了当前工具链中的编译器版本。

如果你在某个设置了工具链覆盖的项目目录下运行 rustup show，输出可能会是这样：

bash
rustup show

输出示例：

“`
Default host: x86_64-unknown-linux-gnu
rustup home: /home/yourusername/.rustup

stable-x86_64-unknown-linux-gnu (override)
rustc 1.70.0 (90c541806 2023-05-31)

stable-x86_64-unknown-linux-gnu (default)
rustc 1.70.0 (90c541806 2023-05-31)
“`

解释：
* 这里显示了两个工具链。第一个带有 (override) 标记，说明当前目录正在使用这个工具链作为覆盖。
* 第二个带有 (default) 标记，表示它是全局默认工具链。在没有覆盖的目录中，rustup 会使用它。
* 注意，这个例子中覆盖工具链和默认工具链恰好是同一个版本。如果设置了不同的版本，这里会清晰地显示出来。

2. 安装工具链 (rustup install)

安装一个新的 Rust 工具链版本。你可以安装 stable, beta, nightly，或者特定的历史版本。

“`bash

安装最新的 stable 工具链 (如果已安装则更新)

rustup install stable

安装最新的 beta 工具链

rustup install beta

安装最新的 nightly 工具链

rustup install nightly

安装特定的历史版本 (例如 1.60.0)

rustup install 1.60.0

安装特定目标平台的工具链 (通常不需要这样做，只需安装工具链再添加目标)

rustup install stable-aarch64-apple-darwin # 安装 macOS stable ARM 版本工具链

“`

rustup 会自动检测你的系统架构，并安装对应架构的工具链。例如，在 M1 Mac 上，rustup install stable 会安装 stable-aarch64-apple-darwin。在 Intel Mac 上，会安装 stable-x86_64-apple-darwin。

3. 设置默认工具链 (rustup default)

将某个已安装的工具链设置为全局默认工具链。

“`bash

将 stable 工具链设置为默认

rustup default stable

将 nightly 工具链设置为默认

rustup default nightly

将特定版本设置为默认

rustup default 1.60.0
“`

设置后，你在任何没有覆盖的目录中运行 rustc 或 cargo，都会使用这个新的默认工具链。

4. 列出已安装工具链 (rustup list)

查看所有已经安装在你的系统中的工具链。

bash
rustup list

输出示例：

stable-x86_64-unknown-linux-gnu (default)
nightly-x86_64-unknown-linux-gnu
1.60.0-x86_64-unknown-linux-gnu

解释：
* 列出了每个已安装工具链的完整名称（通道/版本号-目标平台）。
* (default) 标记了当前的默认工具链。

5. 更新工具链 (rustup update)

更新已安装的所有工具链到它们的最新版本（stable 到最新的 stable，beta 到最新的 beta，nightly 到最新的 nightly）。

“`bash

更新所有已安装的工具链

rustup update

只更新 stable 工具链

rustup update stable

只更新 nightly 工具链

rustup update nightly
“`

这个命令非常重要，因为它让你的 Rust 环境始终保持最新状态，能够使用最新的特性和修复。建议定期运行此命令。

6. 管理工具链覆盖 (rustup override)

为当前目录或指定目录设置、查看或移除工具链覆盖。

“`bash

为当前目录设置工具链覆盖为 nightly

rustup override set nightly

为当前目录设置工具链覆盖为特定版本

rustup override set 1.60.0

查看当前目录的覆盖设置 (也可以用 rustup show)

rustup override list

移除当前目录的工具链覆盖

rustup override unset

移除指定目录的工具链覆盖

rustup override unset –path /path/to/your/project
“`

使用 rustup override set 命令会在当前目录下创建一个 .rustup-toolchain 文件，文件内容就是指定的工具链名称，例如 nightly 或 1.60.0。你也可以手动编辑这个文件来更改覆盖设置。这个文件应该被添加到你的项目版本控制（如 Git）中，以确保所有协作者使用相同的 Rust 版本。

7. 管理目标平台 (rustup target)

添加或移除对特定目标平台的编译支持。

“`bash

列出所有可用目标平台

rustup target list

列出当前工具链已安装的目标平台

rustup target list –installed

为当前的默认/覆盖工具链添加对 aarch64-apple-darwin 目标的标准库支持

rustup target add aarch64-apple-darwin

为特定的工具链添加目标平台支持 (例如为 nightly 添加 wasm32-unknown-unknown 支持)

rustup target add wasm32-unknown-unknown –toolchain nightly

移除对 aarch64-apple-darwin 目标的支持

rustup target remove aarch64-apple-darwin
“`

添加目标平台支持后，你就可以使用 cargo build --target <target-name> 命令进行交叉编译了。例如，如果你在 Linux (x86_64) 上想编译一个程序运行在树莓派 (aarch64) 上，你需要：
1. 确保你有一个合适的工具链（如 stable-x86_64-unknown-linux-gnu）。
2. 运行 rustup target add aarch64-unknown-linux-gnu。
3. 在项目目录中运行 cargo build --target aarch64-unknown-linux-gnu。

8. 管理组件 (rustup component)

安装、移除或列出与工具链相关的可选组件。

“`bash

列出当前工具链所有可用的组件

rustup component list

列出当前工具链已安装的组件

rustup component list –installed

为当前的默认/覆盖工具链安装 rustfmt 组件

rustup component add rustfmt

为当前的默认/覆盖工具链安装 clippy 组件

rustup component add clippy

同时安装多个组件

rustup component add rustfmt clippy

为特定工具链安装组件 (例如为 nightly 安装 rust-docs)

rustup component add rust-docs –toolchain nightly

移除 rustfmt 组件

rustup component remove rustfmt
“`

安装 rustfmt 和 clippy 是非常推荐的操作，它们能帮助你写出符合社区规范、质量更高的 Rust 代码。许多 IDE 和编辑器插件也依赖这些组件。

9. 查看文档 (rustup doc)

在浏览器中打开当前安装的 Rust 工具链的本地文档。

bash
rustup doc

这会打开标准库、常用工具等的文档。如果你安装了 rust-docs 组件，即使离线也能访问文档。你也可以指定查看特定组件或模块的文档：

“`bash

查看 Cargo 的文档

rustup doc –book cargo

查看标准库的文档 (如果你安装了 rust-docs)

rustup doc std
“`

10. 更新 rustup 自身 (rustup self update)

rustup 自身也会不定期更新，以获取新功能或修复 bug。

bash
rustup self update

11. 卸载 rustup (rustup self uninstall)

如果出于某种原因需要完全移除 Rust 和 rustup，可以使用此命令。

bash
rustup self uninstall

此命令会移除 ~/.rustup 和 ~/.cargo 目录（Windows 上通常是 %USERPROFILE%\.rustup 和 %USERPROFILE%\.cargo），并尝试清理 PATH 环境变量中的相关条目。

第四部分：高级用法与场景

1. 使用特定工具链执行命令 (rustup run)

虽然工具链覆盖 (rustup override) 是管理项目依赖工具链的首选方法，但有时你可能只想临时使用某个工具链执行一个命令，而不改变目录的覆盖设置或全局默认。这时可以使用 rustup run 命令：

“`bash

使用 nightly 工具链编译当前项目

rustup run nightly cargo build

使用 1.60.0 工具链运行测试

rustup run 1.60.0 cargo test

使用 stable 工具链执行 rustfmt 格式化代码

rustup run stable rustfmt src/main.rs
“`

rustup run <toolchain> <command> [args...] 会在指定工具链的环境下执行后面的命令。

2. 配置环境变量

rustup 的行为可以通过一些环境变量进行配置，例如：
* RUSTUP_HOME: 指定 rustup 的安装目录，默认是 ~/.rustup。
* CARGO_HOME: 指定 Cargo 的 home 目录，包注册表缓存、编译好的二进制文件等会放在这里，默认是 ~/.cargo。
* RUSTUP_TOOLCHAIN: 临时指定当前命令使用的工具链，优先级高于默认工具链和目录覆盖。

例如：

“`bash

使用环境变量临时指定工具链执行命令

RUSTUP_TOOLCHAIN=nightly cargo build
“`

这个方法不如 rustup run 直观，但在某些自动化脚本场景下可能有用。

3. 处理网络代理和防火墙

如果你的网络环境需要通过代理才能访问外部资源，或者有防火墙限制，rustup 的下载可能会失败。你可以通过设置系统或 Shell 的代理相关的环境变量来解决：

• HTTP_PROXY
• HTTPS_PROXY

例如 (Linux/macOS):

“`bash
export HTTP_PROXY=”http://your.proxy.server:port”
export HTTPS_PROXY=”http://your.proxy.server:port”

如果需要认证

export HTTP_PROXY=”http://user:[email protected]:port”

export HTTPS_PROXY=”http://user:[email protected]:port”

rustup update # 现在会通过代理下载
“`

请根据你的实际代理设置替换 your.proxy.server:port 和认证信息。

4. 使用特定的 Rust 版本格式

当你安装或指定工具链时，可以使用多种格式：

• 通道名称: stable, beta, nightly。rustup 会解析为最新的该通道版本。
• 版本号: 1.60.0。rustup 会查找并安装该特定版本。
• 完整工具链名称: stable-x86_64-unknown-linux-gnu, 1.60.0-aarch64-apple-darwin。明确指定通道/版本和目标平台。当你需要在不同架构之间切换工具链本身时（而不是交叉编译），这会很有用。

通常，直接使用通道名称 (stable, beta, nightly) 或版本号 (1.60.0) 就足够了，rustup 会自动选择适合你当前系统的目标平台。

第五部分：故障排除

在使用 rustup 的过程中，可能会遇到一些问题。以下是一些常见的故障及解决方法：

1. 命令未找到 (command not found: rustc 或 cargo)：

   • 原因： ~/.cargo/bin 目录没有被添加到系统的 PATH 环境变量中，或者 PATH 变量更改后未生效。
   • 解决：
     • 对于 Linux/macOS，确认 rustup-init.sh 脚本是否成功修改了你的 Shell 配置文件（如 .bashrc, .zshenv）。手动编辑文件，添加类似 export PATH="$HOME/.cargo/bin:$PATH" 的行。然后关闭并重新打开终端，或执行 source ~/.your_shell_profile。
     • 对于 Windows，确认 %USERPROFILE%\.cargo\bin 已被添加到用户或系统 PATH 环境变量。如果未添加，手动添加。然后关闭并重新打开命令提示符或 PowerShell。
     • 检查 ~/.cargo/bin 目录下是否存在 rustc、cargo 等文件。
     • 如果你使用了非标准的 Shell，可能需要手动配置其启动文件。

2. 网络连接问题 (failed to download, connection refused 等)：

   • 原因： 防火墙阻止访问、需要通过代理、DNS 解析问题等。
   • 解决：
     • 检查网络连接是否正常。
     • 设置 HTTP_PROXY 和 HTTPS_PROXY 环境变量（参见上面的高级用法）。
     • 尝试更换 DNS 服务器。
     • 暂时关闭防火墙进行测试（如果允许）。

3. MSVC 工具链问题 (Windows):

   • 原因： 缺少 Visual C++ Build Tools 或 Visual Studio 组件。
   • 解决： 安装 Visual Studio Community Edition 并勾选 C++ 相关工作负载，或安装 Build Tools for Visual Studio。确保安装过程中包含 MSVC 工具链。

4. 权限问题 (permission denied)：

   • 原因： rustup 或 Cargo 尝试在没有写入权限的目录创建文件，或者安装目录本身权限设置有问题。
   • 解决：
     • 确保当前用户对 ~/.rustup 和 ~/.cargo 目录有完全的读写权限。
     • 避免使用 sudo 运行 rustup 或 cargo 命令，除非你知道自己在做什么。使用 sudo 可能导致文件创建在 root 用户下，从而引起后续的权限问题。

5. 组件安装失败 (如 rustfmt 或 clippy)：

   • 原因： 尝试安装的组件与当前工具链不兼容，或网络问题。
   • 解决：
     • 运行 rustup component list --toolchain <your-toolchain> 查看该工具链可用的组件列表。
     • 确保网络连接正常。
     • 尝试更新工具链 (rustup update) 再重新安装组件。

6. 特定工具链问题 (如 nightly 版本不稳定)：

   • 原因： nightly 版本是开发中的版本，可能包含 bug 或未完成的功能。
   • 解决：
     • 如果不是必须使用 nightly 的不稳定特性，切换回 stable 版本 (rustup default stable 或使用覆盖)。
     • 查看 Rust 的 issues 报告，看看是否有人遇到了相同问题。

如果遇到其他难以解决的问题，可以尝试：
* 查看 rustup 的官方文档：rustup doc rustup
* 在 Rust 官方论坛或 Discord 频道寻求帮助。
* 在 GitHub 仓库中搜索或提交 rustup 的 issue。

结论

rustup 是 Rust 开发环境的官方且推荐的安装与管理工具。它极大地简化了 Rust 工具链的获取、更新和管理过程。通过 rustup，你可以轻松地在不同 Rust 版本、不同目标平台以及各种辅助工具之间切换，满足不同项目和开发阶段的需求。

本文详细介绍了 rustup 的安装、核心概念和常用命令，包括工具链的安装、切换、更新，目标平台的添加，组件的管理，以及项目级覆盖等。掌握这些内容，你将能够自如地管理你的 Rust 开发环境，专注于编写高质量的 Rust 代码。

请记住，Rust 生态系统活跃且发展迅速，定期运行 rustup update 是保持环境最新和获取最新功能及性能改进的好习惯。同时，善用 rustup override 来为特定项目锁定工具链版本，能够避免因为 Rust 版本更新带来的兼容性问题。

现在，你已经具备了使用 rustup 的所有必要知识。立即打开你的终端，开始你的 Rust 编程之旅吧！祝你编程愉快！

---