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,并按照提示选择选项。

在Windows下工具链会安装到%USERPROFILE%\.cargo\bin文件夹下并添加到$PATH环境变量。

Linux & OSX

运行以下命令

  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 0.1.12 (c6e430a 2016-05-12)
  3. #The Rust toolchain installer
  4. #
  5. #USAGE:
  6. #    rustup [FLAGS] [SUBCOMMAND]
  7. #
  8. #FLAGS:
  9. #    -v, --verbose    Enable verbose output
  10. #    -h, --help       Prints help information
  11. #    -V, --version    Prints version information
  12. #
  13. #SUBCOMMANDS:
  14. #    show         Show the active and installed toolchains
  15. #    update       Update Rust toolchains
  16. #    default      Set the default toolchain
  17. #    toolchain    Modify or query the installed toolchains
  18. #    target       Modify a toolchain's supported targets
  19. #    override     Modify directory toolchain overrides
  20. #    run          Run a command with an environment configured for a given toolchain
  21. #    which        Display which binary will be run for a given command
  22. #    doc          Open the documentation for the current toolchain.
  23. #    self         Modify the rustup installation
  24. #    telemetry    rustup telemetry commands
  25. #    help         Prints this message or the help of the given subcommand(s)
  26. #
  27. #rustup installs The Rust Programming Language from the official
  28. #release channels, enabling you to easily switch between stable, beta,
  29. #and nightly compilers and keep them updated. It makes cross-compiling
  30. #simpler with binary builds of the standard library for common platforms.
  31. #
  32. #If you are new to Rust consider running `rustup doc --book`
  33. #to learn Rust.

根据提示, 使用 rust help <command> 来查看子命令的帮助, 基本看这些帮助文档就足够了。

我们可以使用rustup default <toolchain> 配置默认的工具链。

其中标准的 <toolchain>具有如下的形式 <channel>[-<date>][-<host>]

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

如stable-x86_64-pc-windows-msvc nightly-2014-12-18 1.8.0等都是合法的toolchain名称。

我们也可以采用自定义toolchain配合rustup。

下面着重介绍几个常用的命令。

rustup override add <toolchain> 添加一个目录以及其子目录的默认工具链。

rustup override remove <toolchain> 删除一个目录以及其子目录的默认工具链。

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

rustup toolchain install <toolchain> 安装特定的的工具链。

rustup toolchain link <toolchain-name> "<toolchain-path>" 设置自定义工具链。

rustup target add <target> 设置工具链的可用目标。

rustup update 检查安装工具链的更新。