# 安装

第一步当然就是安装 Rust。我们将通过 rustup(一个用于管理 Rust 版本和相关工具的命令行工具)下载 Rust。你需要互联网连接才能下载。

注:如果由于某些原因你不想使用 rustup,请参阅Rust 安装页面 (opens new window)以获取其他选项。

以下步骤将安装 Rust 编译器的最新稳定版本。Rust 的稳定性保证可确保本文档中所有可编译的示例都将继续使用较新的 Rust 版本进行编译。 不同版本之间的输出可能会略有不同,因为 Rust 经常会改进错误消息和警告。 换句话说,使用这些步骤安装的任何较新的稳定版本的 Rust 都应该可以按本文档的预期工作。

命令行符号 在本章以及整个文档中,我们将展示一些在终端中使用的命令。你应在终端中输入的行均以$开头。你无需输入$字符,它指示每个命令的开始。不以$开头的行通常显示前一个命令的输出。此外,特定于PowerShell的示例将使用>而不是$。

# 在 Linux 或 macOS 上安装 rustup

如果你使用的是 Linux 或 macOS,请打开一个终端并输入以下命令:

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

该命令将下载一个脚本并开始安装 rustup 工具,该工具将安装 Rust 的最新稳定版本。可能会提示你输入密码。如果安装成功,将显示以下行:

Rust is installed now. Great!

如果你愿意的话,请在运行脚本之前先下载脚本并进行检查。

下次登录后,安装脚本会自动将 Rust 添加到系统环境变量 PATH 中。如果要立即开始使用 Rust,而不是重新启动终端,请在 Shell 中运行以下命令,以将 Rust 手动添加到系统环境变量 PATH 中:

$ source $HOME/.cargo/env

另外,你可以将以下行添加到~/.bash_profile中:

$ export PATH="$HOME/.cargo/bin:$PATH"

此外,你将需要某种链接程序。可能已经安装了一个链接程序,但是当你尝试编译 Rust 程序并收到错误消息,表明该链接程序无法执行时,意味着你的系统上尚未安装链接程序,你需要手动安装一个链接程序。 C 编译器通常带有正确的链接程序。 查看平台的文档,了解如何安装 C 编译器。 另外,一些常见的 Rust 包依赖于 C 代码,并且需要 C 编译器。因此,可能值得立即安装一个。

# 在 windows 上下载 rustup

在 Windows 上,前往rustup (opens new window)并按照说明安装 Rust。在安装过程中的某个时刻,你会收到一条消息,说明你还需要安装 Visual Studio 2013 或更高版本的 C++构建工具。获取该构建工具的最简单方法是安装Visual Studio 2019 安装构建工具 (opens new window)。这些工具都集成在所安装的工具中。

本文档的其余可使用的命令均可在cmd.exePowerShell中使用,如果有特定差异,我们将说明使用哪个命令工具。

# 更新与卸载

通过 rustup 安装 Rust 后,很容易更新到最新版本。在你的终端PowerShell中,运行以下更新脚本:

$ rustup update

要卸载 Rust 和 rustup,请从你的PowerShell中运行以下卸载脚本:

$ rustup self uninstall

# 故障排除

检查你的 Rust 是否正确安装,在你的PowerShell运行如下脚本:

$ rustc --version

你应该看到已发布的最新稳定版本的版本号,提交历史记录和提交日期,格式如下:

rustc x.y.z (abcabcabc yyyy-mm-dd)

如果你看到此信息,则说明你已成功安装 Rust!如果你没有看到此信息,并且你使用的是 Windows,请检查 Rust 是否在%PATH%系统变量中。 如果一切正确,但 Rust 仍然无法正常工作,你可以在许多地方获得帮助。最简单的是the official Rust Discord (opens new window)中的#beginners channel。在这里,你可以与其他可以帮助你的 Rust 爱好者(Rustaceans 是 Rust 编程语言社区成员的一个非正式的昵称,可以理解为 Rust 的爱好者)聊天。 其它如the Users forum (opens new window)论坛和Stack Overflow (opens new window)

# 本地文件

Rust 的安装还包括本地文档的副本,因此你可以离线阅读。运行rustup doc在浏览器中即可打开本地文档。每当标准库提供类型或函数时,如果你不确定它的用途或用法,请使用应用程序编程接口(API)文档进行查找!

# 以下为本人安装过程

前往官方下载文档,我们可以看到如下图所示:

安装rust

如果你的系统是 32 位则选择 32 位下载,否则选择 64 位下载。然后等待如下程序下载完成:

rust-init

下载完成之后,在你的本地磁盘找到该exe程序双击并运行。如下图所示:

rust-init-open

输入Y也就是yes进行下一步。

rust-init-open

enter继续下一步,如果有杀毒软件如 360,金山毒霸之类的提示修改特殊系统启动项,请选择允许。然后这是一个漫长的安装过程,耐心等待吧!

当你看到如下图所示,就表示 Rust 安装成功。

安装成功

输入命令rustc --version我们可以看到版本号,如下图所示:

rust版本

# 在线编辑器

如果你不想安装,只想学习语法,可以前往Rust 在线编辑器 (opens new window),这是一个在线运行代码的编辑器。