mirror of
https://github.com/rust-lang/rustlings.git
synced 2025-12-28 14:59:18 +00:00
166 lines
5.4 KiB
Markdown
166 lines
5.4 KiB
Markdown
<div class="oranda-hide">
|
||
|
||
# rustlings 🦀❤️
|
||
|
||
</div>
|
||
|
||
> ### *這是 Rustlings 的繁體中文翻譯版本。此版本包含了所有練習的中文註釋和文檔翻譯 **（還在努力...）**。*
|
||
|
||
歡迎來到 `rustlings`。這個專案包含一些小練習，可幫助您習慣閱讀和編寫 Rust 程式碼。包括閱讀和回應編譯器訊息！
|
||
|
||
另外，對於 Rust 初學者，還有以下資源可以參考：
|
||
|
||
- [The Book](https://doc.rust-lang.org/book/index.html) - 最全面的 Rust 學習資源，但有時有點理論性。建議您可以搭配 Rustlings 一起使用！
|
||
- [Rust By Example](https://doc.rust-lang.org/rust-by-example/index.html) - 透過小練習來學習 Rust！和 `rustlings` 類似，但是是線上的。
|
||
|
||
## 新手上路
|
||
|
||
_Note: 如果您使用的是 MacOS，請確保您已安裝 Xcode 及其開發人員工具，方法是輸入 `xcode-select --install`._
|
||
_Note: 如果您使用的是 Linux，請確保您已安裝 gcc。 Deb: `sudo apt install gcc`. Yum: `sudo yum -y install gcc`._
|
||
|
||
您需要安裝 Rust。 您可以至 <https://rustup.rs> 取得它。這也將安裝 Cargo（Rust 的套件/專案管理器）。
|
||
|
||
## 安裝
|
||
|
||
> 如果您的電腦還沒安裝 Git，請先安裝。
|
||
> ### 安裝 Git
|
||
> #### macOS
|
||
> 1. 安裝 Homebrew（如果還沒有安裝）：<br>
|
||
> 打開終端，運行以下命令來安裝 Homebrew：
|
||
> ```sh
|
||
> /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
|
||
> ```
|
||
> 2. 使用 Homebrew 安裝 Git：
|
||
> ```sh
|
||
> brew install git
|
||
> ```
|
||
> #### Windows
|
||
> 可以從 Git 官網下載安裝程序：
|
||
> 1. 前往 [Git for Windows](https://gitforwindows.org/) 下載最新版本的安裝程序。
|
||
> 2. 運行下載的安裝程序，按照提示完成安裝。
|
||
> #### Linux
|
||
> 可以使用系統的包管理器來安裝 Git。以下是一些常見的 Linux 發行版的安裝命令：
|
||
> * Ubuntu/Debian：
|
||
> ```sh
|
||
> sudo apt update
|
||
> sudo apt install git
|
||
> ```
|
||
> * Fedora：
|
||
> ```sh
|
||
> sudo dnf install git
|
||
> ```
|
||
> * Arch Linux：
|
||
> ```sh
|
||
> sudo pacman -S git
|
||
> ```
|
||
|
||
安裝好 Git 之後，請依照以下順序執行命令安裝這個翻譯版本的庫：
|
||
|
||
**1. 打開 `終端機` 或 `命令提示字元` 並導航到您希望克隆倉庫的目錄。例如，如果您希望將倉庫克隆到桌面，可以運行：**
|
||
```sh
|
||
cd ~/Desktop
|
||
```
|
||
**2. 執行克隆命令：**
|
||
```sh
|
||
git clone https://github.com/TimLai666/rustlings-zh-TW.git
|
||
```
|
||
**3. 安裝相關套件：**
|
||
```sh
|
||
cargo install --git https://github.com/TimLai666/rustlings-zh-TW
|
||
```
|
||
|
||
## 進行練習
|
||
|
||
**1. 進入倉庫目錄：**
|
||
```sh
|
||
cd rustlings-zh-TW
|
||
```
|
||
**2. 運行 Rustlings 命令開始練習，例如：**
|
||
```sh
|
||
rustlings watch
|
||
```
|
||
<br>
|
||
|
||
練習題按照主題排序，您可以在子目錄 `rustlings-zh-TW/exercises/<主題>` 中找到它們。每個主題都有一個附加的解說文件，其中包含一些資源，可幫助您了解該主題。我們強烈建議您在開始之前先看一下它們。
|
||
|
||
這些任務很簡單。大多數練習包含錯誤，導致它們無法編譯，您的任務就是修復這些錯誤！有些練習也會作為測試運行，但 rustlings 會以相同的方式處理它們。要按照推薦順序執行這些練習，請執行以下命令：
|
||
|
||
```bash
|
||
rustlings watch
|
||
```
|
||
|
||
以上命令將使 rustlings 嘗試按照預定順序（我們認為最適合新手的順序）驗證每個練習的完成情況。每當您更改 `exercises/` 目錄中的文件時，它都會自動重新運行。如果您只想運行一次，可以使用以下命令：
|
||
|
||
```bash
|
||
rustlings verify
|
||
```
|
||
|
||
這將與 `watch` 命令執行相同的操作，但會在運行後退出。
|
||
|
||
如果您想按照自己的順序進行，或只想驗證單個練習，可以執行以下命令：
|
||
|
||
```bash
|
||
rustlings run myExercise1
|
||
```
|
||
|
||
或者，只需使用以下命令來運行課程中下一個未解決的練習：
|
||
|
||
```bash
|
||
rustlings run next
|
||
```
|
||
|
||
如果您遇到困難，可以執行以下命令來獲取該練習的提示：
|
||
|
||
```bash
|
||
rustlings hint myExercise1
|
||
```
|
||
|
||
您也可以使用以下命令獲取下一個未解決練習的提示：
|
||
|
||
```bash
|
||
rustlings hint next
|
||
```
|
||
|
||
要檢查您的進度，可以執行以下命令：
|
||
|
||
```bash
|
||
rustlings list
|
||
```
|
||
|
||
## 自我測驗
|
||
|
||
每隔幾個章節後，會有一個測驗來檢驗您對多個章節的知識。這些測驗可以在 `exercises/quizN.rs` 中找到。
|
||
|
||
## 啟用 `rust-analyzer`
|
||
|
||
執行命令 `rustlings lsp`，這會在項目的根目錄生成一個 `rust-project.json` 文件，以允許 [rust-analyzer](https://rust-analyzer.github.io/) 解析每個練習。
|
||
|
||
## 持續學習
|
||
|
||
完成 Rustlings 後，將您的新知識學以致用！通過建立自己的項目、為 Rustlings 做貢獻，或找到其他開源項目進行貢獻，繼續練習您的 Rust 技能。
|
||
|
||
## 解除安裝 Rustlings
|
||
|
||
如果您想從系統中刪除 Rustlings，有兩個步驟。首先，您需要刪除安裝腳本為您建立的練習資料夾：
|
||
|
||
```bash
|
||
rm -rf rustlings-zh-TW # 或您自定義的資料夾名稱，如果您重命名過它。
|
||
```
|
||
|
||
接著，運行 `cargo uninstall` 來移除 `rustlings` 可執行文件：
|
||
|
||
```bash
|
||
cargo uninstall rustlings
|
||
```
|
||
|
||
這樣應該就可以了！
|
||
|
||
## 參與貢獻
|
||
|
||
請參閱 [CONTRIBUTING.md](https://github.com/rust-lang/rustlings/blob/main/CONTRIBUTING.md)。
|
||
|
||
## 貢獻者 ✨
|
||
|
||
感謝 [AUTHORS.md](https://github.com/rust-lang/rustlings/blob/main/AUTHORS.md) 中列出的所有出色的人士 🎉
|
||
|