Skip to content

TimLai666/rustlings-zh-TW

 
 

Repository files navigation

rustlings 🦀❤️

這是 Rustlings 的繁體中文翻譯版本。此版本包含了所有練習的中文註釋和文檔翻譯。

歡迎來到 rustlings。這個專案包含一些小練習,可幫助您習慣閱讀和編寫 Rust 程式碼。包括閱讀和回應編譯器訊息!

另外,對於 Rust 初學者,還有以下資源可以參考:

  • The Book - 最全面的 Rust 學習資源,但有時有點理論性。建議您可以搭配 Rustlings 一起使用!
  • Rust By Example - 透過小練習來學習 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(如果還沒有安裝):
    打開終端,運行以下命令來安裝 Homebrew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. 使用 Homebrew 安裝 Git:
brew install git

Windows

可以從 Git 官網下載安裝程序:

  1. 前往 Git for Windows 下載最新版本的安裝程序。
  2. 運行下載的安裝程序,按照提示完成安裝。

Linux

可以使用系統的包管理器來安裝 Git。以下是一些常見的 Linux 發行版的安裝命令:

  • Ubuntu/Debian:
sudo apt update
sudo apt install git
  • Fedora:
sudo dnf install git
  • Arch Linux:
sudo pacman -S git

安裝好 Git 之後,請依照以下順序執行命令安裝這個翻譯版本的庫:

1. 打開 終端機命令提示字元 並導航到您希望克隆倉庫的目錄。例如,如果您希望將倉庫克隆到桌面,可以運行:

cd ~/Desktop

2. 執行克隆命令:

git clone https://github.com/TimLai666/rustlings-zh-TW.git

3. 安裝相關套件:

cargo install --git https://github.com/TimLai666/rustlings-zh-TW

進行練習

1. 進入倉庫目錄:

cd rustlings-zh-TW

2. 運行 Rustlings 命令開始練習,例如:

rustlings watch

練習題按照主題排序,您可以在子目錄 rustlings-zh-TW/exercises/<主題> 中找到它們。每個主題都有一個附加的解說文件,其中包含一些資源,可幫助您了解該主題。我們強烈建議您在開始之前先看一下它們。

這些任務很簡單。大多數練習包含錯誤,導致它們無法編譯,您的任務就是修復這些錯誤!有些練習也會作為測試運行,但 rustlings 會以相同的方式處理它們。要按照推薦順序執行這些練習,請執行以下命令:

rustlings watch

以上命令將使 rustlings 嘗試按照預定順序(我們認為最適合新手的順序)驗證每個練習的完成情況。每當您更改 exercises/ 目錄中的文件時,它都會自動重新運行。如果您只想運行一次,可以使用以下命令:

rustlings verify

這將與 watch 命令執行相同的操作,但會在運行後退出。

如果您想按照自己的順序進行,或只想驗證單個練習,可以執行以下命令:

rustlings run myExercise1

或者,只需使用以下命令來運行課程中下一個未解決的練習:

rustlings run next

如果您遇到困難,可以執行以下命令來獲取該練習的提示:

rustlings hint myExercise1

您也可以使用以下命令獲取下一個未解決練習的提示:

rustlings hint next

要檢查您的進度,可以執行以下命令:

rustlings list

自我測驗

每隔幾個章節後,會有一個測驗來檢驗您對多個章節的知識。這些測驗可以在 exercises/quizN.rs 中找到。

啟用 rust-analyzer

執行命令 rustlings lsp,這會在項目的根目錄生成一個 rust-project.json 文件,以允許 rust-analyzer 解析每個練習。

持續學習

完成 Rustlings 後,將您的新知識學以致用!通過建立自己的項目、為 Rustlings 做貢獻,或找到其他開源項目進行貢獻,繼續練習您的 Rust 技能。

解除安裝 Rustlings

如果您想從系統中刪除 Rustlings,有兩個步驟。首先,您需要刪除安裝腳本為您建立的練習資料夾:

rm -rf rustlings-zh-TW # 或您自定義的資料夾名稱,如果您重命名過它。

接著,運行 cargo uninstall 來移除 rustlings 可執行文件:

cargo uninstall rustlings

這樣應該就可以了!

參與貢獻

請參閱 CONTRIBUTING.md

貢獻者 ✨

感謝 AUTHORS.md 中列出的所有出色的人士 🎉

About

rustlings庫的繁體中文翻譯!

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 93.6%
  • Shell 2.9%
  • PowerShell 1.9%
  • Nix 1.6%