Rust 安裝

安裝

ch01-01-installation.md

commit 1e17bf15b12f6f7b8d1711dbd343ef8993f64baa

第一步是安裝 Rust。我們會通過 rustup 下載 Rust，這是一個管理 Rust 版本和相關工具的命令行工具。下載時需要聯網。

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

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

命令行標記

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

在 Linux 或 macOS 上安裝 rustup

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

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

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

Rust is installed now. Great!

另外，你還需要一個 鏈接器（linker），這是 Rust 用來將其編譯的輸出連接到一個文件中的程序。很可能你已經有一個了。如果你遇到了鏈接器錯誤，請嘗試安裝一個 C 編譯器，它通常包括一個鏈接器。C 編譯器也很有用，因為一些常見的 Rust 包依賴于 C 代碼，因此需要安裝一個 C 編譯器。

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

$ xcode-select --install

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

在 Windows 上安裝 rustup

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

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

本書的余下部分會使用能同時運行于 cmd.exe 和 PowerShell 的命令。如果存在特定差異，我們會解釋使用哪一個。

檢查安裝是否正確（Troubleshooting）

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

$ rustc --version

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

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

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

譯者：恭喜入坑?。ù颂帒撚姓坡暎。?/p>

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

在 Windows CMD 中，請使用命令：

> echo %PATH%

在 PowerShell 中，請使用命令：

> echo $env:Path

在 Linux 和 macOS 中，請使用命令：

echo $PATH

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

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

更新與卸載

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

$ rustup update

若要卸載 Rust 和 rustup，請在命令行中運行如下卸載腳本:

$ rustup self uninstall

本地文檔

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

任何時候，如果你拿不準標準庫中的類型或函數的用途和用法，請查閱應用程序接口（application programming interface，API）文檔！