Rustup — Rust 的版本管理器

Minimum Rust version: various (this tool has its own versioning scheme and works with all Rust versions)

Rustup 工具已成为推荐的安装 Rust 的方式,并在我们的网站上有。它的功能远不止于此,允许您管理各种版本,组件和平台。

安装 Rustup

要通过 Rustup 安装 Rust,您可以访问 https://www.rust-lang.org/install.html,它将告诉您如何在您的平台上执行此操作。 这将安装 rustup 本身和 rustccargostable 版本。

安装 Rust 的其他版本,执行 rustup install

  1. $ rustup install 1.30.0

对每夜版也是有效的:

  1. $ rustup install nightly-2018-08-01

三种最新的版本:

  1. $ rustup install stable
  2. $ rustup install beta
  3. $ rustup install nightly

升级

升级所有安装的版本,你可以执行:

  1. $ rustup update

这将查看您已安装的所有内容,如果有新版本,将会更新。

版本管理

设置非 stable 的为默认版本:

  1. $ rustup toolchain default nightly

使用一个 toolchain 而不是默认的,rustup run

  1. $ rustup run nightly cargo build

还有一个别名,这个更短一些:

  1. $ cargo +nightly build

如果您希望每个目录具有不同的默认值,那也很容易! 如果你在项目中运行它:

  1. $ rustup override set nightly

然后当你在那个目录中时,rustccargo 的任何调用都将使用该工具链。 要与其他人共享,可以使用工具链的内容创建一个 rust-toolchain 文件,并将其检入源代码管理中。 现在,当有人克隆您的项目时,他们将获得正确的版本,而无需自己“覆盖集合”。

安装其他目标 (target)

Rust 支持交叉编译到其他平台,Rustup 可以帮助您管理它们。 例如,要使用 MUSL:

  1. $ rustup target add x86_64-unknown-linux-musl

然后,你可以:

  1. $ cargo build --target=x86_64-unknown-linux-musl

查看所有安装的目标:

  1. $ rustup target list

安装组件

组件用于安装某些类型的工具。虽然大多数工具都提供了“cargo-install”,但有些工具需要深入集成到编译器中。 Rustup 确切地知道您正在使用的编译器版本,因此它只具有这些工具所需的信息。

组件是每个工具链,因此如果您希望它们可用于多个工具链,则需要多次安装它们。 在下面的示例中,添加一个 --toolchain 标志,设置为您要安装的工具链,例如 nightly。 如果没有此标志,它将安装默认工具链的组件。

要查看可以安装的完整组件列表:

  1. $ rustup component list

接下来,让我们谈谈一些流行的组件以及何时需要安装它们。

rust-docs, 本地文档

安装工具链时,默认情况下会安装此第一个组件。 它包含 Rust 的文档副本,以便您可以脱机阅读。

此组件暂时无法删除; 如果感兴趣,请对 this issue 发表评论。

rust-src 标准库代码的拷贝

rust-src 组件可以为您提供 Rust 的源代码的本地副本。你为什么需要这个?好吧,像 Racer 这样的自动完成工具使用这些信息来了解你要调用的函数的更多信息。

  1. $ rustup component add rust-src

“预览”组件

“预览”阶段有几个组件。 这些组件的名称目前都有 -preview,这表明它们还没有100%准备好进行一般使用。 请尝试一下并给我们反馈,但要知道他们不遵循 Rust 的稳定性保证,并且仍然在积极地改变,可能是以向后不兼容的方式。

rustfmt-preview 自动代码格式化

Minimum Rust version: 1.24

如果您希望自动格式化代码,可以安装此组件:

  1. $ rustup component add rustfmt-preview

这将安装两个工具,rustfmtcargo-fmt,它们将为您自动格式化代码! 例如:

  1. $ cargo fmt

将重新格式化您的整个 cargo 项目。

rls-preview 为了 IDE 集成

Minimum Rust version: 1.21

许多 IDE 功能都是基于 langserver协议 构建的。要使用这些 IDE 获得对 Rust 的支持,您需要安装 Rust 语言服务器,即“RLS”:

  1. $ rustup component add rls-preview

你的 IDE 应该从那拿到它。

clippy-preview 更多的 lints

要获得更多的 lints 来帮助你编写 Rust 代码,你可以安装 clippy

  1. $ rustup component add clippy-preview

This will install cargo-clippy for you:

  1. $ cargo clippy

更多信息,查阅 clippy’s documentation.

llvm-tools-preview 使用额外的LLVM工具

如果您想使用 lld 链接器或其他工具,如 llvm-objdumpllvm-objcopy,您可以安装此组件:

  1. $ rustup component add llvm-tools-preview

这是最新的组件,因此目前没有良好的文档。