Rust 学习笔记(一)安装

翻译自:
https://doc.rust-lang.org/book/ch01-01-installation.html

安装 Rust 的第一步是通过 rustup 下载 Rust,rustup 是一个用于管理 Rust 版本及相关工具的命令行工具。下载过程需要联网。

直连官网下载会比较慢可以设置以下环境变量:

1
2
RUSTUP_DIST_SERVER=https://rsproxy.cn
RUSTUP_UPDATE_ROOT=https://rsproxy.cn/rustup

以下步骤将安装 Rust 编译器的最新稳定版本。Rust 的稳定性保证确保了本书中所有能编译的示例代码在更新的 Rust 版本中也能继续编译。不过,由于 Rust 经常改进错误信息和警告,不同版本之间的输出可能会略有差异。换句话说,使用这些步骤安装的任何更新的稳定版本的 Rust 都应该能与本书内容正常配合使用。

命令行符号

在本章以及本书的其余部分中,我们会展示一些在终端中使用的命令。所有需要你在终端中输入的行都以 $ 开头。你无需输入 $ 字符,它是命令行提示符,用于表示每条命令的开始。不以 $ 开头的行通常显示的是上一条命令的输出。此外,PowerShell 特有的示例将使用 > 而不是 $

在 Linux 或 macOS 上安装 rustup

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

1
$ curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh

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

1
Rust is installed now. Great!

你还需要一个链接器,这是一个 Rust 用来将编译输出合并为一个文件的程序。你很可能已经安装了一个链接器。如果你遇到链接器错误,你应该安装一个 C 编译器,它通常会包含一个链接器。C 编译器也很有用,因为一些常见的 Rust 包依赖于 C 代码,需要一个 C 编译器。

在 macOS 上,你可以通过运行以下命令来获取 C 编译器:

1
$ xcode-select --install

Linux 用户通常应根据其发行版的文档安装 GCC 或 Clang。例如,如果你使用的是 Ubuntu,可以安装 build-essential 包。

在 Windows 上安装 rustup

在 Windows 上,前往 https://www.rust-lang.org/tools/install 并按照安装 Rust 的说明进行操作。在安装过程中,你会被提示安装 Visual Studio,它提供了编译程序所需的链接器和本地库。如果需要更多帮助,请查看 https://rust-lang.github.io/rustup/installation/windows-msvc.html

本书其余部分使用的命令在 cmd.exe 和 PowerShell 中都能正常工作。如果有特定的差异,我们会说明使用哪一个。

排查问题

要检查 Rust 是否正确安装,打开一个 shell 并输入以下命令:

1
$ rustc --version

你应该会看到最新稳定版本的版本号、提交哈希和提交日期,格式如下:

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

如果你看到了这些信息,说明你已经成功安装了 Rust!如果你没有看到这些信息,请检查 Rust 是否已添加到你的 %PATH% 系统变量中。

在 Windows CMD 中,使用以下命令:

1
> echo %PATH%

在 PowerShell 中,使用以下命令:

1
> echo $env:Path

在 Linux 和 macOS 中,使用以下命令:

1
$ echo $PATH

如果一切正确,但 Rust 仍然无法工作,你可以通过社区页面了解如何与其他 Rustaceans(我们给自己起的有趣昵称)联系以获取帮助。

更新和卸载

通过 rustup 安装 Rust 后,更新到新发布的版本非常简单。在你的 shell 中运行以下更新脚本:

1
$ rustup update

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

1
$ rustup self uninstall

本地文档

Rust 的安装还包括了本地文档副本,以便你可以离线阅读。运行 rustup doc 命令,即可在浏览器中打开本地文档。

任何时候,如果你不确定标准库提供的类型或函数的作用或使用方法,都可以使用应用程序编程接口(API)文档来查找。

文本编辑器和集成开发环境

本书不对编写 Rust 代码所使用的工具做任何假设。几乎任何文本编辑器都可以完成这项工作!然而,许多文本编辑器和集成开发环境(IDE)都为 Rust 提供了内置支持。你可以在 Rust 网站的工具页面上找到一份相当新的编辑器和 IDE 列表。

江达小记