Cargo — Package Manager & Build Tool ของ Rust

Cargo คือ npm + tsc + jest ในเครื่องเดียว

ถ้าเคยใช้ npm (หรือ yarn/pnpm) มาก่อน Cargo จะคุ้นมือทันที เพราะจัดการ dependency, build project, รันโค้ดและรัน test ได้ครบในตัวเดียว

สร้าง project ใหม่

# Node / TypeScript
mkdir my-app && cd my-app
npm init -y
npm install typescript --save-dev

# Rust
cargo new my-app   # creates a binary (has fn main)
cargo new my-lib --lib   # creates a library (no fn main)
cd my-app

cargo new สร้างโครงสร้าง:

flowchart TD
  root["my-app/"] --> toml["Cargo.toml — like package.json"]
  root --> lock["Cargo.lock — like package-lock.json"]
  root --> src["src/"]
  src --> main["main.rs — entry point"]

สิ่งที่ cargo new สร้าง

Cargo.toml เทียบกับ package.json

// package.json
{
  "name": "my-app",
  "version": "1.0.0",
  "dependencies": {
    "express": "^4.18.0"
  },
  "devDependencies": {
    "typescript": "^5.0.0",
    "@types/express": "^4.17.0"
  }
}

# Cargo.toml
[package]
name = "my-app"
version = "0.1.0"
edition = "2024"

[dependencies]
axum = "0.8"
tokio = { version = "1", features = ["full"] }
serde = { version = "1", features = ["derive"] }

[dev-dependencies]
# crate สำหรับ test เท่านั้นใส่ที่นี่

เพิ่ม dependencies

# npm
npm install serde_json        # runtime dep
npm install --save-dev vitest # dev dep

# Cargo
cargo add serde_json          # runtime dep
cargo add --dev pretty_assertions  # dev dep

cargo add อัปเดต Cargo.toml อัตโนมัติ เหมือนกับ npm install ทุกประการ

Subcommand หลัก

cargo build          # compile (debug, fast, unoptimized)
cargo build --release  # compile (optimized, slower build)
cargo run            # compile + execute
cargo run -- --port 8080  # pass args to your binary
cargo check          # type-check only, no binary (very fast)
cargo test           # run all tests
cargo test my_fn     # run tests whose name contains "my_fn"
cargo doc --open     # generate + open HTML docs
cargo clean          # delete target/ directory

Cargo.lock — commit หรือไม่?

# Binary / application  →  COMMIT Cargo.lock (reproducible builds)
# Library crate         →  DO NOT commit Cargo.lock (let consumers pick versions)

นี่สอดคล้องกับ convention ของ npm: application commit package-lock.json แต่ library ที่ publish มักไม่ commit

🟦 edition = 2024 คืออะไร

Rust ออก edition ใหม่ทุก 3 ปี (2015, 2018, 2021, 2024) edition อาจมี syntax change ที่ breaking แต่ compiler สามารถ migrate code ให้อัตโนมัติด้วย cargo fix --edition สำหรับ project ใหม่ให้ใช้ edition = "2024" — cargo new เลือกให้อยู่แล้ว และเป็นตัวที่ปลดล็อก let chain, การ drop temporary ของ if let ก่อนเข้า branch else และ unsafe extern block

สิ่งที่ใกล้เคียงที่สุดฝั่ง TypeScript คือ target/lib ใน tsconfig.json แต่ต่างกันข้อสำคัญ: edition กำหนด ต่อ crate ไม่ใช่ต่อทั้งโปรแกรม crate ที่ใช้ 2024 depend crate ที่ใช้ 2015 ได้และกลับกันก็ได้ ecosystem จึงไม่แตก และคุณอัปเกรดตามจังหวะตัวเองได้