---

Rust 安装教程：零基础入门，一步到位

欢迎来到 Rust 的世界！Rust 是一门注重性能、内存安全和并发性的系统级编程语言，近年来受到了越来越多开发者的喜爱。它被 Stack Overflow 开发者调查连续多年评选为“最受欢迎的编程语言”，这足以证明它的魅力和潜力。

如果你对 Rust 充满好奇，想要亲手体验它的强大，那么第一步自然是安装 Rust 开发环境。本教程将为你提供一份详尽、保姆级的安装指南，即使你没有任何编程经验，也能跟着步骤轻松完成安装。我们将覆盖 Windows、macOS 和 Linux 这三大主流操作系统，并详细讲解安装过程、验证方法以及安装后需要了解的基本概念。

准备好了吗？让我们开始 Rust 的探索之旅！

1. 为什么选择 Rust？（简单了解）

在开始安装之前，花一点点时间了解为什么 Rust 如此受欢迎，可能会让你更有动力。Rust 的核心优势在于：

• 内存安全（Memory Safety）： 在没有垃圾回收器的情况下，Rust 通过其所有权（Ownership）、借用（Borrowing）和生命周期（Lifetimes）系统，在编译时保证内存安全，杜绝了空指针引用、数据竞争等常见错误。
• 高性能（Performance）： Rust 编译为本地机器码，没有运行时开销，其性能可以与 C 和 C++ 相媲美，甚至在某些场景下表现更优。
• 并发性（Concurrency）： Rust 的所有权系统使得编写线程安全的代码变得容易，可以在编译时发现数据竞争问题。
• 可靠性（Reliability）： 强大的类型系统和编译时检查帮助你在开发早期捕获大量错误。
• 生产力（Productivity）： 虽然学习曲线可能稍陡峭，但 Rust 提供了优秀的工具链（如 Cargo 包管理器）、清晰的错误信息和丰富的文档，一旦掌握，开发效率会很高。

这些特性使得 Rust 成为开发操作系统、嵌入式系统、命令行工具、WebAssembly 应用、网络服务等高性能和高可靠性应用的理想选择。

2. 安装前的准备

在开始安装 Rust 之前，请确保你具备以下条件：

1. 稳定的互联网连接： Rust 安装程序和组件需要从网络下载。
2. 基本的电脑操作能力： 知道如何打开命令行工具（终端或命令提示符）。
3. 足够的硬盘空间： Rust 工具链需要一定的空间，但通常不会占用太多（几个百兆到一两个 G）。
4. 操作系统的基本了解： 知道你使用的是 Windows、macOS 还是 Linux（以及大致版本）。

对于 Windows 用户，你可能需要提前安装一些 C++ 构建工具。这是因为 Rust 默认会链接到系统的 C/C++ 运行时库，并且一些 Rust 包（crates）在编译时可能需要 C/C++ 编译器。最推荐的方式是安装 Visual Studio Build Tools 或 Visual Studio Community Edition（选择安装“使用 C++ 的桌面开发”工作负载）。这个步骤可以在安装 Rust 之后根据提示完成，或者提前完成。我们会在 Windows 安装部分详细说明。

3. 认识 Rust 的主要工具：rustup、rustc 和 cargo

Rust 的官方推荐安装方式是使用一个名为 rustup 的工具。rustup 是 Rust 的官方工具链管理器，它的作用非常重要：

• 安装 Rust 工具链： 它会帮你下载并安装 rustc（Rust 编译器）、cargo（Rust 的构建工具和包管理器）、标准库以及其他附属工具（如代码格式化工具 rustfmt、代码检查工具 clippy、文档工具 rustdoc 等）。
• 管理不同版本的 Rust： Rust 有稳定版（stable）、测试版（beta）和夜间版（nightly）。rustup 可以让你轻松地在这些版本之间切换或安装特定版本。对于初学者，稳定版是最佳选择。
• 管理不同平台（target）的 Rust： Rust 可以编译到不同的操作系统和硬件架构上。rustup 可以安装这些平台的交叉编译工具链。
• 更新 Rust 工具链： 你可以使用 rustup 轻松地将 Rust 更新到最新版本。

理解了 rustup 的作用，我们再来看另外两个核心工具：

• rustc： 这是 Rust 的编译器。你编写的 Rust 代码最终会由 rustc 编译成可执行文件或库。通常情况下，你不需要直接调用 rustc，而是通过 cargo 来间接使用它。
• cargo： 这是 Rust 的构建系统和包管理器。它是 Rust 生态系统中不可或缺的一部分。cargo 负责：
  • 创建新项目： 使用 cargo new 可以快速创建一个标准的 Rust 项目骨架。
  • 管理依赖： Rust 的第三方库称为 “crates”。cargo 通过 Cargo.toml 文件来管理项目的依赖关系，并自动从 crates.io（Rust 的官方包注册中心）下载和构建所需的库。
  • 构建项目： 使用 cargo build 命令编译你的项目。
  • 运行项目： 使用 cargo run 命令编译并运行你的项目。
  • 测试项目： 使用 cargo test 命令运行项目中的自动化测试。
  • 生成文档： 使用 cargo doc 命令为你的代码生成文档。

可以说，cargo 是你日常开发 Rust 时打交道最多的工具。rustup 安装完成后，rustc 和 cargo 也会随之安装并添加到你的系统 PATH 环境变量中，这样你就可以在任何地方直接通过命令行调用它们了。

现在，让我们针对不同的操作系统，详细讲解如何安装 rustup。

4. 安装 Rust（分操作系统）

请根据你使用的操作系统，选择相应的安装步骤。

4.1. Windows 系统安装

Windows 上安装 Rust 非常方便，主要通过下载并运行一个安装程序完成。

步骤 1：下载 rustup-init.exe

打开你的网页浏览器，访问 Rust 官方安装页面：https://www.rust-lang.org/tools/install

页面会自动检测你的操作系统并提供相应的下载链接。找到 Windows 对应的下载链接，点击下载 rustup-init.exe 文件。

步骤 2：运行 rustup-init.exe

找到下载好的 rustup-init.exe 文件（通常在你的“下载”文件夹里），双击运行它。

如果系统弹出用户账户控制（UAC）提示，请允许程序运行。

步骤 3：在命令行中进行配置

运行 rustup-init.exe 后，它会在一个新的命令行窗口中启动安装过程。你会看到类似以下的欢迎信息：

“`
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’s bin directory to your PATH environment
variable.

3) Customize installation
2) Continue with default installation (recommended)
1) Cancel installation

“`

这里有几个选项：

• 3) Customize installation: 自定义安装，可以修改安装路径、选择安装哪些组件、默认使用哪个版本的 Rust（stable, beta, nightly）等。
• 2) Continue with default installation (recommended): 继续使用默认安装。这是最推荐的选项，特别是对于初学者。它会安装最新稳定版的 Rust、Cargo 以及其他常用工具，并将 Cargo 的 bin 目录（包含 rustc, cargo 等可执行文件）添加到你的系统 PATH 环境变量中。
• 1) Cancel installation: 取消安装。

对于初学者，强烈建议输入 2 并按回车键，选择默认安装。

接下来，安装程序会开始下载和安装 Rust 组件。这个过程可能需要一些时间，取决于你的网络速度。你会看到下载进度和正在安装的组件信息。

安装完成后，你会看到类似以下的成功信息：

“`
Rust is installed now. Great!

To get started you may need to restart your current shell.
This would reload your PATH.

To learn more about Rust, please visit: https://www.rust-lang.org/learn

Press the Enter key to continue.
“`

这意味着 Rust 已经成功安装到你的系统中了。安装程序提示你需要重启当前的命令行窗口（shell）来让 PATH 环境变量的更改生效。

步骤 4：安装 Visual Studio Build Tools（如果需要）

在默认安装过程中，rustup 会检测你的系统是否已经安装了 C++ 构建工具。如果没有安装，它可能会给出提示，或者某些需要编译 C/C++ 代码的 Rust 包在后续构建时会失败。

最稳妥的方式是安装 Microsoft 的 Build Tools for Visual Studio。

访问 Visual Studio 下载页面：https://visualstudio.microsoft.com/zh-hans/downloads/

向下滚动找到“Visual Studio 的工具”（Tools for Visual Studio）部分，下载并运行 Build Tools for Visual Studio 的安装程序。

运行安装程序后，选择“工作负载”（Workloads）选项卡，勾选 “使用 C++ 的桌面开发”（Desktop development with C++）。

(注意：截图可能因版本不同而略有差异，但基本选项类似)

点击右下角的“安装”按钮。这个安装过程可能需要下载几 G 的数据，并占用较多硬盘空间，请耐心等待。

安装完成后，重启电脑以确保所有相关的环境变量和配置都生效。虽然有时候不重启也可以，但重启能避免很多潜在问题。

步骤 5：打开新的命令提示符或 PowerShell 窗口

安装完成后，关闭所有之前打开的命令提示符或 PowerShell 窗口。然后通过 Windows 的搜索功能，搜索“命令提示符”（Command Prompt）或“PowerShell”，并打开一个新的窗口。这是为了加载 Rust 安装程序修改过的 PATH 环境变量。

步骤 6：验证安装

在新的命令提示符或 PowerShell 窗口中，输入以下命令并按回车：

bash
rustc --version

如果安装成功，你应该会看到 Rust 编译器的版本信息，类似这样：

rustc x.y.z (abcde 2023-01-01)
这里的 x.y.z 是 Rust 的版本号，后面的括号里是具体的提交信息。

然后，输入以下命令并按回车，验证 Cargo 是否安装成功：

bash
cargo --version

你应该会看到 Cargo 的版本信息，类似这样：

cargo x.y.z (abcde 2023-01-01)

如果这两个命令都能正确显示版本信息，恭喜你！你已经在 Windows 上成功安装了 Rust。

4.2. macOS 系统安装

在 macOS 上，通常使用终端（Terminal）通过脚本来安装 Rust，这与 Linux 的方式类似。

步骤 1：安装 Xcode Command Line Tools

在安装 Rust 之前，你需要确保安装了 Xcode Command Line Tools。这些工具包含了一些 Rust 编译所需的底层库和工具（如 C 编译器和链接器）。

打开“应用程序” -> “实用工具” -> “终端”（Terminal）。

在终端中输入以下命令并按回车：

bash
xcode-select --install

系统会弹出一个软件更新窗口，询问你是否安装命令行开发者工具。点击“安装”并同意许可协议。下载和安装过程可能需要一些时间，取决于你的网络速度。

如果你的 Xcode Command Line Tools 已经安装过了，终端会提示：“xcode-select: error: command line tools are already installed, use “Software Update” to update”。

步骤 2：下载并运行 rustup 安装脚本

打开终端（如果刚才关闭了，请重新打开）。

输入以下命令并按回车：

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

让我们分解一下这个命令：
* curl: 一个用于传输数据的命令行工具，这里用于下载安装脚本。
* --proto '=https' --tlsv1.2: 确保使用安全的 HTTPS 协议和 TLS 1.2 版本进行下载，增强安全性。
* https://sh.rustup.rs: 这是 rustup 安装脚本的官方下载地址。
* -sSf: curl 的选项，-s 静默模式不显示进度条，-S 在静默模式下显示错误，-f 失败时返回错误码。
* |: 管道符，将 curl 命令的输出（即下载的脚本内容）作为输入传递给下一个命令。
* sh: 执行 shell 脚本的命令，这里用于执行下载下来的 rustup 安装脚本。

运行该命令后，你会看到类似 Windows 安装时的欢迎信息：

“`
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’s bin directory to your PATH environment
variable.

3) Customize installation
2) Continue with default installation (recommended)
1) Cancel installation

“`

和 Windows 上一样，输入 2 并按回车选择默认安装。

安装程序会下载和安装 Rust 工具链。过程完成后，你会看到成功信息，并提示你需要重新启动终端或执行特定的命令来更新 PATH 环境变量。

“`
Rust is installed now. Great!

To get started you may need to restart your current shell.
This would reload your PATH.

To learn more about Rust, please visit: https://www.rust-lang.org/learn

Press the Enter key to continue.
“`

步骤 3：更新 PATH 环境变量（如果需要）

rustup 安装脚本会尝试自动修改你的 shell 配置文件（比如 ~/.bash_profile, ~/.zshrc 等，取决于你使用的 shell）来将 ~/.cargo/bin 目录添加到 PATH 环境变量中。

要让 PATH 更改生效，你有两种方法：

1. 重启终端： 关闭当前终端窗口，然后重新打开一个新的终端窗口。这是最简单可靠的方法。
2. 手动加载配置文件： 在当前终端中，根据你使用的 shell 执行相应的命令。例如，如果使用 Zsh（macOS Catalina 及更新版本的默认 shell）：
   bash
source ~/.zshrc
   如果使用 Bash（较旧版本的 macOS 默认 shell）：
   bash
source ~/.bash_profile
# 或者可能是 source ~/.bashrc 或 source ~/.profile
rustup 的安装信息会提示你具体是哪个文件被修改了。

选择其中一种方法来更新 PATH。

步骤 4：验证安装

在新的终端窗口中，输入以下命令并按回车：

bash
rustc --version

如果安装成功，你会看到 Rust 编译器的版本信息。

接着，输入以下命令并按回车，验证 Cargo：

bash
cargo --version

你会看到 Cargo 的版本信息。

如果两个命令都能正确显示版本号，说明 Rust 已成功安装在你的 macOS 系统上。

4.3. Linux 系统安装

Linux 上的安装方式与 macOS 非常相似，也是通过终端脚本完成。

步骤 1：打开终端

打开你的 Linux 发行版的终端应用程序。这通常可以在应用程序菜单中找到，或者使用快捷键（如 Ctrl + Alt + T）。

步骤 2：下载并运行 rustup 安装脚本

在终端中输入以下命令并按回车：

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

这个命令的含义与 macOS 部分解释的一样：使用 curl 下载安装脚本，并通过管道符将其传递给 sh 命令执行。

运行后，你会看到 rustup 的欢迎信息：

“`
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’s bin directory to your PATH environment
variable.

3) Customize installation
2) Continue with default installation (recommended)
1) Cancel installation

“`

同样地，输入 2 并按回车选择默认安装。

安装程序会开始下载和安装 Rust 工具链。耐心等待下载和安装完成。

完成后，你会看到成功信息，并提示需要重新启动终端或执行特定的命令来更新 PATH 环境变量：

“`
Rust is installed now. Great!

To get started you may need to restart your current shell.
This would reload your PATH.

To learn more about Rust, please visit: https://www.rust-lang.org/learn

Press the Enter key to continue.
“`

步骤 3：安装 C/C++ 构建工具链（如果需要）

Rust 默认会链接到系统的 C/C++ 运行时库，并且一些 Rust 包可能依赖于 C/C++ 编译器和链接器。大多数 Linux 发行版默认已经安装了这些工具（通常是 GCC 或 Clang）。如果你的系统比较精简，或者在后续使用 Cargo 构建某些项目时遇到链接错误，你可能需要手动安装这些工具。

安装方式取决于你的 Linux 发行版使用的包管理器：

• Debian/Ubuntu及其衍生版 (使用 apt):
  bash
sudo apt update
sudo apt install build-essential
build-essential 元包通常包含了 GCC/G++ 编译器、make 工具以及其他必要的开发库。

• Fedora/CentOS/RHEL及其衍生版 (使用 dnf 或 yum):
  bash
sudo dnf groupinstall "Development Tools" # 或者 sudo yum groupinstall "Development Tools"
Development Tools 组包含了 GCC、GDB、make 等常用的开发工具。

• Arch Linux及其衍生版 (使用 pacman):
  bash
sudo pacman -Syu
sudo pacman -S base-devel
base-devel 组包含了构建软件包所需的基本工具，包括 GCC 和 make。

输入相应的命令，并根据提示输入你的用户密码以执行 sudo 命令。

步骤 4：更新 PATH 环境变量

和 macOS 类似，rustup 会修改你的 shell 配置文件（如 ~/.bashrc, ~/.zshrc, ~/.profile 等）来添加 ~/.cargo/bin 到 PATH。

你需要关闭当前终端窗口并重新打开一个新的终端窗口，或者在当前终端中手动加载配置文件（例如 source ~/.bashrc），以使 PATH 更改生效。请参考 rustup 安装完成时的提示信息，它会告诉你修改了哪个文件。

步骤 5：验证安装

在新的终端窗口中，输入以下命令并按回车：

bash
rustc --version

如果安装成功，你会看到 Rust 编译器的版本信息。

接着，输入以下命令并按回车，验证 Cargo：

bash
cargo --version

你会看到 Cargo 的版本信息。

如果两个命令都能正确显示版本号，说明 Rust 已成功安装在你的 Linux 系统上。

5. 安装后的初步了解

现在你已经成功安装了 Rust 工具链，让我们回顾一下安装了什么，以及接下来可以做什么。

你通过 rustup 安装了：

• rustc：Rust 编译器。
• cargo：Rust 的构建工具和包管理器。
• rustup：Rust 工具链管理器本身。
• 标准库源代码和文档（离线版本，非常有用！）。
• 其他附属工具（如 rustfmt, clippy 等）。

这些工具的可执行文件都被放在了你用户目录下的 .cargo/bin 目录中（例如 Windows 上的 C:\Users\你的用户名\.cargo\bin，macOS/Linux 上的 ~/.cargo/bin）。rustup 安装时已经将这个目录添加到了你的系统 PATH 环境变量中，所以你可以在任何地方直接运行 rustc, cargo, rustup 等命令。

6. 你的第一个 Rust 项目！

安装完成后，最好的下一步就是创建一个简单的 Rust 项目来验证一切是否正常工作，并感受一下 cargo 的便利。

打开你的命令行工具（命令提示符/PowerShell/终端）。

选择一个你想要创建项目的目录（例如，你可以进入你的用户目录或者创建一个专门存放代码的文件夹）。使用 cd 命令切换目录。例如：

“`bash

在你的用户目录下

cd ~

或者创建一个新目录并进入

mkdir rust_projects
cd rust_projects
“`

然后，使用 cargo new 命令创建一个新的 Rust 项目。我们创建一个名为 hello_rust 的项目：

bash
cargo new hello_rust

运行这个命令后，Cargo 会在当前目录下创建一个名为 hello_rust 的新文件夹。进入这个文件夹：

bash
cd hello_rust

现在 hello_rust 文件夹的结构是这样的：

hello_rust/
├── Cargo.toml
└── src/
└── main.rs

• Cargo.toml 是 Cargo 的配置文件（使用 TOML 格式）。它包含了项目的元信息（如名称、版本）、依赖库等。你可以打开它看看里面的内容。
• src/main.rs 是项目的主源文件。对于二进制可执行项目（像我们这里创建的），程序入口点通常是 src/main.rs 中的 fn main() 函数。

用文本编辑器打开 src/main.rs 文件，你会看到 Cargo 已经为你生成了一些示例代码：

rust
fn main() {
println!("Hello, world!");
}

这非常像其他语言中的“Hello, World!”程序。fn main() 定义了一个主函数，println! 是一个宏，用于打印文本到控制台。

现在，让我们使用 Cargo 来构建并运行这个项目。在 hello_rust 目录中，输入以下命令：

bash
cargo run

当你运行 cargo run 命令时，Cargo 会执行以下操作：

1. 检查 Cargo.toml 文件，解析项目配置。
2. 寻找源文件（在 src 目录下）。
3. 使用 rustc 编译 src/main.rs 文件。编译后的可执行文件会放在一个叫做 target/debug 的目录中。
4. 编译成功后，运行 target/debug 目录中的可执行文件。

你应该会在命令行中看到类似以下的输出：

Compiling hello_rust v0.1.0 (/path/to/your/rust_projects/hello_rust)
Finished dev [unoptimized + debuginfo] target(s) in X.XXs
Running `target\debug\hello_rust.exe` # Windows
Running `target/debug/hello_rust` # macOS/Linux
Hello, world!

第一行表示 Cargo 正在编译你的项目。第二行表示编译完成，生成了一个调试版本的可执行文件。第三行表示 Cargo 正在运行编译好的程序。最后一行是你的程序输出的内容。

如果看到了 Hello, world!，恭喜你！你的 Rust 开发环境一切正常，你已经成功运行了你的第一个 Rust 程序！

你可以尝试修改 src/main.rs 文件，比如把 "Hello, world!" 改成 "你好，Rust！"，保存文件，再次运行 cargo run，看看输出是否改变。

7. 常用的 rustup 命令

安装 rustup 后，除了安装本身，你还需要了解一些常用的 rustup 命令来管理你的 Rust 工具链：

• rustup show: 查看当前的 Rust 安装信息，包括默认使用的工具链、已安装的组件等。
• rustup update: 更新 rustup 本身以及默认的 Rust 工具链到最新版本。这是保持你的 Rust 环境最新的重要命令。
• rustup update stable: 只更新稳定版工具链。
• rustup update nightly: 只更新夜间版工具链。
• rustup default stable: 将默认工具链设置为最新稳定版。
• rustup default nightly: 将默认工具链设置为最新夜间版。
• rustup toolchain list: 列出所有已安装的工具链。
• rustup toolchain install <toolchain>: 安装指定的工具链，例如 rustup toolchain install 1.60.0 或 rustup toolchain install beta。
• rustup component list: 列出所有可用的组件（如文档、源代码、各种 lints 等）。
• rustup component add <component>: 为当前的默认工具链添加组件，例如 rustup component add rust-docs 添加离线文档。
• rustup component remove <component>: 移除组件。
• rustup self uninstall: 卸载 Rust 工具链和 rustup 本身。

这些命令能帮助你灵活地管理 Rust 开发环境。

8. 常见问题和故障排除

尽管 rustup 让安装过程变得非常顺畅，但在某些情况下，你可能会遇到一些问题。以下是一些常见问题及其解决方法：

• “command not found: rustc” 或 “command not found: cargo”:

  • 原因： 系统找不到 rustc 或 cargo 命令，通常是因为 ~/.cargo/bin 目录没有被正确添加到系统的 PATH 环境变量中，或者 PATH 更改没有生效。
  • 解决方法：
    1. 重启命令行工具： 关闭所有当前的命令提示符/PowerShell/终端窗口，然后重新打开一个新的。这是最常见的解决方法。
    2. 手动加载配置文件： 如果重启无效，或者你想在当前窗口立即生效，可以手动加载你的 shell 配置文件。根据你的操作系统和 shell，执行 source ~/.bashrc, source ~/.zshrc, source ~/.bash_profile, source ~/.profile (Linux/macOS) 或其他 rustup 安装时提示修改的文件。在 Windows PowerShell 中，可能是 $env:PATH += ";C:\Users\你的用户名\.cargo\bin" 但更推荐重启。
    3. 检查配置文件： 用文本编辑器打开 rustup 修改的 shell 配置文件（如 ~/.bashrc），查找类似 export PATH="$HOME/.cargo/bin:$PATH" 的行，确认它是否存在且路径正确。如果不存在或不正确，手动添加或修正。
    4. 检查 .cargo/bin 目录是否存在： 确认在你的用户目录下（~ 或 C:\Users\你的用户名）存在一个 .cargo 文件夹，并且其中包含一个 bin 文件夹，里面有 rustc.exe, cargo.exe 等文件。如果不存在，说明安装过程本身可能失败了，尝试重新运行 rustup-init。

• Windows 上构建项目时出现链接错误或找不到 MSVC/C++ 编译器相关的错误：

  • 原因： Rust 需要 C++ 构建工具链来链接最终的可执行文件或构建一些依赖于 C 代码的 crate。你可能没有安装 Visual Studio Build Tools，或者安装时没有勾选“使用 C++ 的桌面开发”工作负载，或者安装后没有重启电脑。
  • 解决方法：
    1. 安装 Visual Studio Build Tools： 按照本教程 Windows 安装步骤中的说明，下载并安装 Visual Studio Build Tools，确保勾选“使用 C++ 的桌面开发”工作负载。
    2. 重启电脑： 完成 Visual Studio Build Tools 安装后，务必重启你的 Windows 电脑。

• macOS/Linux 上构建项目时出现链接错误或找不到 GCC/Clang 相关的错误：

  • 原因： 你的系统可能缺少 Rust 编译和链接所需的 C/C++ 工具链（如 GCC 或 Clang）或相关的开发库。
  • 解决方法：
    1. macOS： 确保你已经成功安装了 Xcode Command Line Tools (xcode-select --install)。
    2. Linux： 根据你的发行版，安装 build-essential (Debian/Ubuntu) 或 Development Tools 组 (Fedora/CentOS) 或 base-devel 组 (Arch Linux)。具体命令请参考本教程 Linux 安装步骤。

• 安装过程中提示网络错误或下载失败：

  • 原因： 你的网络连接不稳定，或者存在防火墙、代理等阻止了下载。
  • 解决方法：
    1. 检查网络连接： 确保你的互联网连接稳定。
    2. 检查防火墙/代理： 如果你在公司或学校网络，可能需要配置代理或者防火墙阻止了连接到 static.rust-lang.org 或 crates.io。请咨询你的网络管理员。
    3. 稍后再试： 有时候是临时的网络问题，等待一段时间再尝试安装。
    4. 使用镜像站（高级）： 如果官方源下载困难，部分社区提供了 Rust 工具链和 crates.io 的镜像站。你可以设置环境变量来使用这些镜像，但这超出了本零基础教程的范围，通常不推荐初学者一开始就这样做。

• 安装程序需要管理员权限：

  • 原因： 在 Windows 上运行 .exe 安装程序时，系统会提示 UAC 请求管理员权限，这是正常的。在 Linux/macOS 上，rustup 安装到用户目录 (~/.cargo) 通常不需要 sudo。如果你在执行 curl ... | sh 时被要求输入密码或者使用 sudo sh，请检查你输入的命令是否正确，或者是否有其他原因（比如尝试安装到系统目录）。一般来说，不建议使用 sudo 来运行 rustup 安装脚本，让它安装到用户目录是推荐的方式。然而，安装系统级的 C/C++ 构建工具（如 build-essential）时需要使用 sudo。

如果在遇到问题时无法自行解决，可以尝试在 Rust 社区（如官方论坛 users.rust-lang.org、Discord 频道等）寻求帮助，提供你使用的操作系统版本、遇到的具体错误信息（复制粘贴完整的错误输出）以及你已经尝试过的解决方法，这样更容易获得有效的帮助。

9. 卸载 Rust

如果你出于某种原因需要卸载 Rust，使用 rustup 安装的方式使得卸载也非常简单。

打开命令行工具，输入以下命令并按回车：

bash
rustup self uninstall

rustup 会提示你确认是否要卸载，并说明它将移除 rustup 本身、Rust 工具链以及 ~/.cargo 目录下的所有文件。

This will uninstall all Rust toolchains and data.
...
Continue? (y/N)

输入 y 并按回车确认，rustup 就会自动帮你清理所有相关文件。

卸载完成后，可能仍然需要重启命令行工具或手动更新 PATH 环境变量，以确保 ~/.cargo/bin 从 PATH 中移除。

10. 结语

恭喜你！现在你已经成功地在你的电脑上安装了 Rust 开发环境，并且运行了你的第一个 Rust 程序。这仅仅是 Rust 学习旅程的开端。

接下来，强烈建议你阅读 Rust 官方提供的免费在线书籍 《Rust 程序设计语言》（通常被称为 “The Book”）。这本书是学习 Rust 的最佳资源，内容全面且易于理解。你可以在这里找到它：https://rustwiki.org/zh-CN/book/ (中文版) 或 https://doc.rust-lang.org/book/ (英文版)。

同时，你还可以考虑安装一个支持 Rust 的代码编辑器或集成开发环境（IDE）。VS Code 配合 rust-analyzer 插件是目前非常流行且功能强大的选择。其他编辑器如 IntelliJ IDEA (通过 Rust 插件)、Neovim (通过 LSP) 等也提供了很好的 Rust 支持。一个好的编辑器能提供代码高亮、自动补全、错误检查、代码格式化等功能，极大地提高你的开发效率。

Rust 的社区非常活跃和友好，在学习过程中遇到问题时，不要害怕提问。

祝你在 Rust 的世界里探索愉快，编写出高性能、高可靠性的出色程序！