使用 Cargo 在本機執行程式碼

如果想在自己的系統上進行程式碼實驗,您會需要先安裝 Rust。請按照 Rust 手冊中的指示操作。您應會獲得正常運作的 rustccargo。截至本文撰寫時間,最新的 Rust 穩定版具有下列版本編號:

% rustc --version
rustc 1.69.0 (84c898d65 2023-04-16)
% cargo --version
cargo 1.69.0 (6e9a83356 2023-04-12)

由於 Rust 保有回溯相容性,您也可以使用任何後續版本。

完成上述步驟後,請按照下列步驟操作,在本訓練課程的任一範例中建構 Rust 二進位檔:

  1. 在要複製的範例中,按一下「Copy to clipboard」按鈕。

  2. 使用 cargo new exercise,為程式碼建立新的 exercise/ 目錄:

    $ cargo new exercise
         Created binary (application) `exercise` package
    
  3. 前往 exercise/,使用 cargo run 建構並執行二進位檔:

    $ cd exercise
    $ cargo run
       Compiling exercise v0.1.0 (/home/mgeisler/tmp/exercise)
        Finished dev [unoptimized + debuginfo] target(s) in 0.75s
         Running `target/debug/exercise`
    Hello, world!
    
  4. src/main.rs 中的樣板程式碼替換為自己的程式碼。以上一頁的範例為例,替換後的 src/main.rs 會類似如下:

    fn main() {
        println!("Edit me!");
    }
  5. 使用 cargo run 建構並執行更新版二進位檔:

    $ cargo run
       Compiling exercise v0.1.0 (/home/mgeisler/tmp/exercise)
        Finished dev [unoptimized + debuginfo] target(s) in 0.24s
         Running `target/debug/exercise`
    Edit me!
    
  6. 使用 cargo check 快速檢查專案中是否有錯誤,並使用 cargo build 在不執行的情況下編譯專案。您會在 target/debug/ 中看到一般偵錯版本的輸出內容。使用 cargo build --release,在 target/release/ 中產生經過最佳化的發布子版本。

  7. 只要編輯 Cargo.toml,即可為專案新增依附元件。執行 cargo 指令時,系統會自動下載及編譯缺少的依附元件。

建議您鼓勵課程參與者安裝 Cargo 及使用本機編輯器。這麼做能提供正常的開發環境,降低操作難度。