在 Linux 或 macOS 上安装 Rustup

如果你使用 Linux 或 macOS，打开终端并输入如下命令：

<font style="color:rgb(0, 0, 0);background-color:rgb(246, 247, 246);">curl --proto </font><font style="color:rgb(0, 130, 0);background-color:rgb(246, 247, 246);">'=https'</font><font style="color:rgb(0, 0, 0);background-color:rgb(246, 247, 246);"> --tlsv1.2 https://sh.rustup.rs -sSf | sh</font>

此命令下载一个脚本并开始安装 rustup 工具，这会安装最新稳定版 Rust。过程中可能会提示你输入密码。如果安装成功，将会出现如下内容：

:::info Rust is installed now. Great!


 To get started you may need to restart your current shell. This would reload your PATH environment variable to include Cargo’s bin directory ($HOME/.cargo/bin).
To configure your current shell, you need to source the corresponding env file under $HOME/.cargo.
This is usually done by running one of the following (note the leading DOT): . “$HOME/.cargo/env” # For sh/bash/zsh/ash/dash/pdksh source “$HOME/.cargo/env.fish” # For fish

:::

安装 C 语言编译器：（非必需）
Rust 对运行环境的依赖和 Go 语言很像，几乎所有环境都可以无需安装任何依赖直接运行。但是，Rust 会依赖 libc 和链接器 linker。所以如果遇到了提示链接器无法执行的错误，你需要再手动安装一个 C 语言编译器： macOS 下：

<font style="color:rgb(0, 0, 0);background-color:rgb(246, 247, 246);">xcode-select --install</font>

Linux 下：
Linux 用户一般应按照相应发行版的文档来安装 GCC 或 Clang。 例如，如果你使用 Ubuntu，则可安装 build-essential。

在 Windows 上安装 Rustup

Windows 上安装 Rust 需要有 C++ 环境，以下为安装的两种方式：
  1. x86_64-pc-windows-msvc**（官方推荐）**
    1. 先安装 Microsoft C++ Build Tools，勾选安装 C++ 环境即可。安装时可自行修改缓存路径与安装路径，避免占用过多 C 盘空间。安装完成后，Rust 所需的 msvc 命令行程序需要手动添加到环境变量中，否则安装 Rust 时 rustup-init 会提示未安装 Microsoft C++ Build Tools，其位于：%Visual Studio 安装位置%\VC\Tools\MSVC\%version%\bin\Hostx64\x64（请自行替换其中的 %Visual Studio 安装位置%、%version% 字段）下。
    2. 如果你不想这么做，可以选择安装 Microsoft C++ Build Tools 新增的“定制”终端 Developer Command Prompt for %Visual Studio version% 或 Developer PowerShell for %Visual Studio version%，在其中运行 rustup-init.exe
    3. 准备好 C++ 环境后开始安装 Rust：
    4. 在 RUSTUP-INIT 下载系统相对应的 Rust 安装程序，一路默认即可。

:::info

PS C:\Users\Hehongyuan> rustup-init.exe …… Current installation options: default host triple: x86_64-pc-windows-msvc default toolchain: stable (default) profile: default modify PATH variable: yes 1) Proceed with installation (default) 2) Customize installation 3) Cancel installation

:::

  1. x86_64-pc-windows-gnu
    1. 相比于 MSVC 版本来说，GNU 版本具有更轻量，更靠近 Linux 的优势。
    2. 首先，根据 MSYS2 官网 配置 MSYS。
    3. 若您觉得下载太慢，可以试试由 Caviar-X 提供的 代理。
    4. 在安装 mingw-toolchain 后，请将 %MSYS 安装路径%\mingw64\bin 添加到系统变量 PATH 中。
    5. 配置好后，在 MSYS 中输入下面的命令来安装 rustup。
      1. <font style="color:rgb(0, 0, 0);background-color:rgb(246, 247, 246);">curl https://sh.rustup.rs -sSf | sh</font>
    6. 之后，根据以下输出进行配置。

:::info Current installation options:

default host triple: x86_64-pc-windows-msvc

  1.  default toolchain: stable (default)
  3.            profile: default

modify PATH variable: yes

1) Proceed with installation (default)

2) Customize installation

3) Cancel installation

2

I’m going to ask you the value of each of these installation options.

You may simply press the Enter key to leave unchanged.

Default host triple? [x86_64-pc-windows-msvc]

x86_64-pc-windows-gnu

Default toolchain? (stable/beta/nightly/none) [stable]

stable

Profile (which tools and data to install)? (minimal/default/complete) [default]

complete

Modify PATH variable? (Y/n)

Y

Current installation options:

default host triple: x86_64-pc-windows-gnu

  1.  default toolchain: stable
  3.            profile: complete

modify PATH variable: yes

1) Proceed with installation (default)

2) Customize installation

3) Cancel installation

1

:::

再之后，按下 1，等待。完成后，您就已经安装了 Rust 和 rustup。

更新

要更新 Rust，在终端执行以下命令即可更新：

<font style="color:rgb(0, 0, 0);background-color:rgb(246, 247, 246);">rustup update</font>

卸载

要卸载 Rust 和 rustup，在终端执行以下命令即可卸载：

<font style="color:rgb(0, 0, 0);background-color:rgb(246, 247, 246);">rustup self uninstall</font>

检查是否安装成功

检查是否正确安装了 Rust，可打开终端并输入下面这行，此时能看到最新发布的稳定版本的版本号、提交哈希值和提交日期：

:::info

yog@YogdeMacBook-Air-2 ~ % cargo -V cargo 1.77.0 (3fe68eabf 2024-02-29) yog@YogdeMacBook-Air-2 ~ % rustc -V rustc 1.77.0 (aedd173a2 2024-03-17)

:::

如果没看到，请按照下面说明的方法检查 Rust 是否在您的 %PATH% 系统变量中 在 Windows CMD 中，请使用命令：

<font style="color:rgb(0, 0, 0);">> echo %PATH%</font>

在 PowerShell 中，请使用命令：

<font style="color:rgb(0, 0, 0);">echo $env:Path</font>

在 Linux 和 macOS 中，请使用命令：
<font style="color:rgb(0, 0, 0);">echo $PATH</font> 如果一切正确但 Rust 仍不能使用，有许多地方可以求助。您可以在社区页面查看如何与其他 Rustaceans（Rust 用户的称号，有自嘲意味）联系。