建立 2026-09-19 更新 2026-09-19

第一個程式與 Cargo

Cargo 是 Rust 的專案與套件管理工具，負責建立專案、下載相依套件、編譯、測試與執行。實務上你幾乎不會直接呼叫 rustc，而是透過 Cargo。本頁帶你建立第一個專案，並認識最常用的指令。

Hello, world!

建立新專案並執行：

cargo new hello
cd hello
cargo run

cargo run 會先編譯，再執行，終端機會印出 Hello, world!。

hello/
├── Cargo.toml     # 專案設定與相依套件
├── Cargo.lock     # 實際使用的套件版本（自動產生）
├── src/
│   └── main.rs    # 程式進入點
└── target/        # 編譯產物（不要提交到 Git）

src/main.rs 的內容：

fn main() {
    println!("Hello, world!");
}

Cargo.toml 描述專案：

[package]
name = "hello"
version = "0.1.0"
edition = "2024"

[dependencies]

edition 是 Rust 的語言版本，每隔數年釋出一次，用來引入不相容的語法調整。Rust 2024 edition 自 Rust 1.85 起穩定，新專案預設就是它。

寫程式時多用 cargo check

Rust 編譯較花時間，只想確認有沒有語法或所有權錯誤時，用 cargo check 會快很多。

Rust 的套件稱為 crate，公開發佈在 crates.io。例如要產生亂數，可以加入 rand：

cargo add rand

Cargo 會把它寫進 Cargo.toml 的 [dependencies]，下次編譯時自動下載。Cargo.lock 則記錄實際使用的版本，確保團隊成員與正式環境建置出相同結果。