Rust 版本管理工具: rustup

rustup 是rust官方的版本管理工具。应当作为安装 Rust 的首选。

项目主页是: https://github.com/rust-lang-nursery/rustup.rs

Features

  • 管理安装多个官方版本的 Rust 二进制程序。
  • 配置基于目录的 Rust 工具链。
  • 安装和更新来自 Rust 的发布通道: nightly, beta 和 stable。
  • 接收来自发布通道更新的通知。
  • 从官方安装历史版本的 nightly 工具链。
  • 通过指定 stable 版本来安装。
  • 安装额外的 std 用于交叉编译。
  • 安装自定义的工具链。
  • 独立每个安装的 Cargo metadata。
  • 校验下载的 hash 值。
  • 校验签名 (如果 GPG 存在)。
  • 断点续传。
  • 只依赖 bash, curl 和常见 unix 工具。
  • 支持 Linux, OS X, Windows(via MSYS2)。

安装

Windows

在rustup的主页下载并运行rustup-init.exe,并按照提示选择选项。

  1. Welcome to Rust!
  3. This will download and install the official compiler for the Rust programming
  4. language, and its package manager, Cargo.
  6. It will add the cargo, rustc, rustup and other commands to Cargo's bin
  7. directory, located at:
  9.   C:\Users\Liqueur Librazy\.cargo\bin
  11. This path will then be added to your PATH environment variable by modifying the
  12. HKEY_CURRENT_USER/Environment/PATH registry key.
  14. You can uninstall at any time with rustup self uninstall and these changes will
  15. be reverted.
  17. Current installation options:
  19.    default host triple: x86_64-pc-windows-msvc
  20.      default toolchain: stable
  21.   modify PATH variable: yes
  23. 1) Proceed with installation (default)
  24. 2) Customize installation
  25. 3) Cancel installation

三个选项分别是

1) 开始安装（默认选项）
2) 自定义安装
3) 取消

其中自定义安装可以更改默认架构与工具链、是否添加 PATH。例如想要选择 nightly 工具链可以进行以下自定义

  1. I'm going to ask you the value of each these installation options.
  2. You may simply press the Enter key to leave unchanged.
  4. Default host triple?
  7. Default toolchain? (stable/beta/nightly)
  8. nightly
  10. Modify PATH variable? (y/n)

设置完毕后，选择 1 以开始安装。

Linux & macOS

运行以下命令

  1. curl https://sh.rustup.rs -sSf | sh

这个命令将会编译和安装 rustup, 安装过程中可能会提示你输入 sudo 的密码。 然后, 他会下载和安装 stable 版本的工具链, 当执行 rustc, rustdoc 和 cargo 时, 将会配置他为默认工具链。

Unix 上安装后工具链会被安装到 $HOME/.cargo/bin 目录。

.cargo/bin 目录会被添加到系统的 $PATH 环境变量,重新登录后即可使用 rustc，cargo 等命令。

卸载

  1. rustup self uninstall

用法

安装后会得到一个 rustup 命令, 多使用命令自带的帮助提示, 可以快速定位你需要功能。

帮助

运行 rustup -h 你将会得到如下提示:

  1. ❯ rustup -h
  2. rustup 1.5.0 (92d0d1e9e 2017-06-24)
  3. The Rust toolchain installer
  5. USAGE:
  6.     rustup.exe [FLAGS] [SUBCOMMAND]
  8. FLAGS:
  9.     -v, --verbose    Enable verbose output
  10.     -h, --help       Prints help information
  11.     -V, --version    Prints version information
  13. SUBCOMMANDS:
  14.     show           Show the active and installed toolchains
  15.     update         Update Rust toolchains and rustup
  16.     default        Set the default toolchain
  17.     toolchain      Modify or query the installed toolchains
  18.     target         Modify a toolchain's supported targets
  19.     component      Modify a toolchain's installed components
  20.     override       Modify directory toolchain overrides
  21.     run            Run a command with an environment configured for a given toolchain
  22.     which          Display which binary will be run for a given command
  23.     doc            Open the documentation for the current toolchain
  24.     self           Modify the rustup installation
  25.     set            Alter rustup settings
  26.     completions    Generate completion scripts for your shell
  27.     help           Prints this message or the help of the given subcommand(s)
  29. DISCUSSION:
  30.     rustup installs The Rust Programming Language from the official
  31.     release channels, enabling you to easily switch between stable,
  32.     beta, and nightly compilers and keep them updated. It makes
  33.     cross-compiling simpler with binary builds of the standard library
  34.     for common platforms.
  36.     If you are new to Rust consider running `rustup doc --book` to
  37.     learn Rust.

根据提示, 使用 rust help <command> 来查看子命令的帮助。

rustup doc --book 会打开英文版的 The Rust Programming Language。

常用命令

rustup default <toolchain> 配置默认工具链。

rustup show 显示当前安装的工具链信息。

rustup update 检查安装更新。

rustup toolchain [SUBCOMMAND] 配置工具链

  • rustup toolchain install <toolchain> 安装工具链。
  • rustup toolchain uninstall <toolchain> 卸载工具链。
  • rustup toolchain link <toolchain-name> "<toolchain-path>" 设置自定义工具链。

其中标准的 <toolchain>具有如下的形式

  1. `<channel>[-<date>][-<host>]`
  2. <channel>       = stable|beta|nightly|<version>
  3. <date>          = YYYY-MM-DD
  4. <host>          = <target-triple>

如 stable-x86_64-pc-windows-msvc nightly-2017-7-25 1.18.0 等都是合法的toolchain名称。

rustup override [SUBCOMMAND] 配置一个目录以及其子目录的默认工具链

使用 --path <path> 指定目录或在某个目录下运行以下命令

  • rustup override set <toolchain> 设置该目录以及其子目录的默认工具链。
  • rustup override unset 取消目录以及其子目录的默认工具链。

使用 rustup override list 查看已设置的默认工具链。

rustup target [SUBCOMMAND] 配置工具链的可用目标

  • rustup target add <target> 安装目标。
  • rustup target remove <target> 卸载目标。
  • rustup target add --toolchain <toolchain> <target> 为特定工具链安装目标。

rustup component 配置 rustup 安装的组件

  • rustup component add <component> 安装组件
  • rustup component remove <component> 卸载组件
  • rustup component list 列出可用组件

常用组件：

  • Rust 源代码 rustup component add rust-src
  • Rust Langular Server (RLS) rustup component add rls