Rust 版本管理工具: rustup

rustup 是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

运行以下命令

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

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

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

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

卸载

rustup self uninstall

用法

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

帮助

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

❯ rustup -h
#rustup 0.1.12 (c6e430a 2016-05-12)
#The Rust toolchain installer
#
#USAGE:
#    rustup [FLAGS] [SUBCOMMAND]
#
#FLAGS:
#    -v, --verbose    Enable verbose output
#    -h, --help       Prints help information
#    -V, --version    Prints version information
#
#SUBCOMMANDS:
#    show         Show the active and installed toolchains
#    update       Update Rust toolchains
#    default      Set the default toolchain
#    toolchain    Modify or query the installed toolchains
#    target       Modify a toolchain's supported targets
#    override     Modify directory toolchain overrides
#    run          Run a command with an environment configured for a given toolchain
#    which        Display which binary will be run for a given command
#    doc          Open the documentation for the current toolchain.
#    self         Modify the rustup installation
#    telemetry    rustup telemetry commands
#    help         Prints this message or the help of the given subcommand(s)
#
#rustup installs The Rust Programming Language from the official
#release channels, enabling you to easily switch between stable, beta,
#and nightly compilers and keep them updated. It makes cross-compiling
#simpler with binary builds of the standard library for common platforms.
#
#If you are new to Rust consider running `rustup doc --book`
#to learn Rust.

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

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

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

<channel>       = stable|beta|nightly|<version>
<date>          = YYYY-MM-DD
<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 检查安装工具链的更新。