Rust 安裝

安裝

ch01-01-installation.md

commit 1e17bf15b12f6f7b8d1711dbd343ef8993f64baa

第一步是安裝 Rust。我們會(huì)通過 rustup 下載 Rust，這是一個(gè)管理 Rust 版本和相關(guān)工具的命令行工具。下載時(shí)需要聯(lián)網(wǎng)。

注意：如果你出于某些理由傾向于不使用 ?rustup?，請(qǐng)到 Rust 的其他安裝方法頁面 查看其它安裝選項(xiàng)。

接下來的步驟會(huì)安裝最新的穩(wěn)定版 Rust 編譯器。Rust 的穩(wěn)定性確保本書所有示例在最新版本的 Rust 中能夠繼續(xù)編譯。不同版本的輸出可能略有不同，因?yàn)?Rust 經(jīng)常改進(jìn)錯(cuò)誤信息和警告。也就是說，任何通過這些步驟安裝的最新穩(wěn)定版 Rust，都應(yīng)該能正常運(yùn)行本書中的內(nèi)容。

命令行標(biāo)記

本章和全書中，我們會(huì)展示一些在終端中使用的命令。所有需要輸入到終端的行都以 $ 開頭。你不需要輸入$字符；這里顯示的$字符表示命令行提示符，僅用于提示每行命令的起點(diǎn)。不以 $ 起始的行通常展示前一個(gè)命令的輸出。另外，PowerShell 專用的示例會(huì)采用 > 而不是 $。

在 Linux 或 macOS 上安裝 rustup

如果你使用 Linux 或 macOS，打開終端并輸入如下命令：

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

此命令下載一個(gè)腳本并開始安裝 rustup 工具，這會(huì)安裝最新穩(wěn)定版 Rust。過程中可能會(huì)提示你輸入密碼。如果安裝成功，將會(huì)出現(xiàn)如下內(nèi)容：

Rust is installed now. Great!

另外，你還需要一個(gè) 鏈接器（linker），這是 Rust 用來將其編譯的輸出連接到一個(gè)文件中的程序。很可能你已經(jīng)有一個(gè)了。如果你遇到了鏈接器錯(cuò)誤，請(qǐng)嘗試安裝一個(gè) C 編譯器，它通常包括一個(gè)鏈接器。C 編譯器也很有用，因?yàn)橐恍┏Ｒ姷?Rust 包依賴于 C 代碼，因此需要安裝一個(gè) C 編譯器。

在 macOS 上，你可以通過運(yùn)行以下命令獲得 C 語言編譯器：

$ xcode-select --install

Linux 用戶通常需要根據(jù)發(fā)行版（distribution）文檔安裝 GCC 或 Clang。比如，如果你使用 Ubuntu，可以安裝 build-essential 包。

在 Windows 上安裝 rustup

在 Windows 上，前往 https://www.rust-lang.org/install.html 并按照說明安裝 Rust。在安裝過程的某個(gè)步驟，你會(huì)收到一個(gè)信息說明為什么需要安裝 Visual Studio 2013 或其更新版本的 MSVC 構(gòu)建工具。要獲取構(gòu)建工具，你需要安裝 Visual Studio 2022。當(dāng)被問及需要安裝什么工作負(fù)載（Workload）的時(shí)候，請(qǐng)確保勾選了以下內(nèi)容：

• “使用 C++ 的桌面開發(fā)”，
• Windows 10 （或 11） SDK，
• 英語語言包，以及其他你所需要的語言包。

本書的余下部分會(huì)使用能同時(shí)運(yùn)行于 cmd.exe 和 PowerShell 的命令。如果存在特定差異，我們會(huì)解釋使用哪一個(gè)。

檢查安裝是否正確（Troubleshooting）

要檢查是否正確安裝了 Rust，打開命令行并輸入：

$ rustc --version

你應(yīng)該可以看到按照以下格式顯示的最新穩(wěn)定版本的版本號(hào)、對(duì)應(yīng)的 Commit Hash 和 Commit 日期：

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

如果看到了這樣的信息，就說明 Rust 已經(jīng)安裝成功了！

譯者：恭喜入坑?。ù颂帒?yīng)該有掌聲?。?/p>

如果沒看到，請(qǐng)按照下面說明的方法檢查 Rust 是否在您的 %PATH% 系統(tǒng)變量中。

在 Windows CMD 中，請(qǐng)使用命令：

> echo %PATH%

在 PowerShell 中，請(qǐng)使用命令：

> echo $env:Path

在 Linux 和 macOS 中，請(qǐng)使用命令：

echo $PATH

如果一切正確但 Rust 仍不能使用，有許多地方可以求助。最簡(jiǎn)單的是位于 Rust 官方 Discord 上的 #beginners 頻道。在這里你可以和其他 Rustacean（Rust 用戶的稱號(hào)，有自嘲意味）聊天并尋求幫助。其它給力的資源包括用戶論壇和 Stack Overflow。

譯者注：這些資源的主要語言都是英語。

更新與卸載

通過 rustup 安裝了 Rust 之后，很容易更新到最新版本，只需要在命令行中運(yùn)行如下更新腳本即可：

$ rustup update

若要卸載 Rust 和 rustup，請(qǐng)?jiān)诿钚兄羞\(yùn)行如下卸載腳本:

$ rustup self uninstall

本地文檔

安裝程序也自帶一份文檔的本地拷貝，可以離線閱讀。運(yùn)行 rustup doc 在瀏覽器中查看本地文檔。

任何時(shí)候，如果你拿不準(zhǔn)標(biāo)準(zhǔn)庫中的類型或函數(shù)的用途和用法，請(qǐng)查閱應(yīng)用程序接口（application programming interface，API）文檔！