Bài 7: Hệ Sinh Thái Rust: Cargo, crates.io, docs.rs, Rust Foundation

Sau bài học, bạn sẽ:

• Hiểu vì sao Cargo gom build, test, doc, publish, lint vào một CLI thay vì phải ghép nhiều tool như JavaScript (ESLint + Prettier + Jest + tsc).
• Biết registry (kho) chính thức crates.io đang ở đâu trong landscape 2026 và cách định danh phiên bản crate trong Cargo.toml.
• Hiểu vai trò của docs.rs — nơi mọi crate publish đều có sẵn API doc auto-build, version-specific.
• Phân biệt 3 channel của rustup: stable, beta, nightly và cách thêm component, target cross-compile (WASM, aarch64...).
• Biết Rust Foundation là tổ chức nào, thành lập khi nào, fund maintainer ra sao, kiểm soát thương hiệu thế nào.
• Có danh sách crate "khởi nghiệp" theo từng domain backend / async / serialization / database / CLI / HTTP / logging / error để không phải dò mò từ đầu.

Cargo là build system kiêm package manager chính thức của Rust. Cài rustup là có Cargo, không phải cài rời. Khác biệt cốt lõi so với hệ JavaScript: trong Node bạn cần npm/pnpm cho dependency, ESLint cho lint, Prettier cho format, Jest/Vitest cho test, tsc cho typecheck, tsup/esbuild cho bundle — 5–6 tool riêng biệt phải config từng cái. Cargo gom tất cả trong một CLI duy nhất, config trong một file Cargo.toml.

Workflow điển hình của một project mới:

cargo new my-api
cd my-api
cargo add tokio --features full
cargo add axum
cargo run

4 lệnh trên đủ để tạo project, thêm 2 crate dependency và chạy. Không cần khởi tạo package.json bằng tay, không cần cài bundler, không cần config TypeScript. Một số subcommand quan trọng:

• cargo check — typecheck nhanh, không gen binary. Vòng feedback ngắn nhất khi đang viết code.
• cargo build / cargo build --release — compile dev / optimized.
• cargo run — build và chạy luôn.
• cargo test — chạy unit test, integration test, doc test trong cùng một lệnh.
• cargo doc --open — sinh HTML doc cho code của bạn và mọi dependency, mở trình duyệt.
• cargo fmt — format theo style chuẩn (rustfmt).
• cargo clippy — linter chính thức, hơn 700 lint rule.
• cargo publish — đẩy crate lên crates.io.
• cargo add / cargo remove / cargo update — quản lý dependency.

Cargo không phải tool bên thứ ba. Nó là tool chính thức do Rust team duy trì, version đi cùng rustc. Mọi crate trên crates.io đều xây bằng Cargo. Không có phân mảnh "team A dùng tool này, team B dùng tool kia" như hệ JS với npm vs yarn vs pnpm vs bun.

crates.io là registry (kho) chính thức cho gói Rust, tương tự npmjs.com của Node hay PyPI của Python. Tính đến giữa năm 2026, registry này có khoảng 150.000 crate (tăng từ ~120.000 cuối 2024), tốc độ tăng đều ~20% mỗi năm. Quy mô vẫn nhỏ hơn npm rất nhiều, nhưng chất lượng trung bình cao hơn vì Rust cộng đồng nghiêng về "ít gói lớn được duy trì kỹ" thay vì "nhiều gói nhỏ tích hợp lẫn nhau".

Cách thêm dependency vào project:

cargo add serde --features derive
cargo add tokio --features full
cargo add reqwest --no-default-features --features rustls-tls

Hoặc viết trực tiếp trong Cargo.toml:

[package]
name = "my-api"
version = "0.1.0"
edition = "2024"

[dependencies]
tokio = { version = "1", features = ["full"] }
axum = "0.7"
serde = { version = "1", features = ["derive"] }
serde_json = "1"
reqwest = { version = "0.12", default-features = false, features = ["rustls-tls", "json"] }

Version pinning theo SemVer caret: "1" nghĩa là >=1.0.0, <2.0.0, Cargo tự chọn bản tương thích mới nhất rồi ghi version cụ thể vào Cargo.lock. Muốn pin chính xác viết "=1.2.3". Muốn cập nhật lock: cargo update.

Trust model: crates.io không có người duyệt thủ công, bất kỳ ai cũng publish được sau khi tạo tài khoản GitHub. Tên crate "first-come first-served" và không thể đổi tên sau khi publish. Bạn cũng không xóa được phiên bản đã publish, chỉ có thể yank để ngăn install mới (Cargo.lock cũ vẫn dùng được). Niềm tin nằm ở maintainer: kiểm tra số download, last update, repo GitHub, người đứng tên trước khi thêm crate quan trọng.

docs.rs là dịch vụ phụ trợ của Rust Foundation: mỗi khi một crate được publish lên crates.io, docs.rs tự chạy cargo doc và host kết quả ở URL https://docs.rs/<ten-crate>. Bạn không cần tự build, không cần tự host. Truy cập docs.rs/tokio hay docs.rs/serde là thấy API doc đầy đủ.

3 đặc điểm khiến docs.rs trở thành công cụ tra cứu không thể thiếu:

• Version-specific — URL có dạng docs.rs/axum/0.7.5. Bạn đang dùng version nào thì xem doc đúng version đó, không bị lệch như Stack Overflow.
• Source link — mọi item (function, struct, trait) có nút "source" mở thẳng đến file .rs đã được render syntax-highlight. Đọc impl thật vài giây sau khi đọc signature.
• Feature flag rõ ràng — doc đánh dấu mỗi item yêu cầu feature nào để compile. Tránh trường hợp copy code mà không biết phải bật feature trong Cargo.toml.

Trong local, lệnh cargo doc --open sinh và mở doc cho code của bạn cùng toàn bộ dependency. Doc viết bằng comment /// (markdown), có thể chứa code example mà cargo test sẽ chạy như test thật — nét đặc thù của Rust giúp ví dụ trong doc luôn cập nhật.

docs.rs xử lý tự build trong sandbox Linux x86_64, mọi crate cần build pass mới có doc. Trang status công khai, build log truy cập được khi debug. So với JavaScript phải dựa vào README và TypeScript declaration rời rạc, docs.rs là một bước nhảy về trải nghiệm đọc tài liệu.

rustup là toolchain (bộ công cụ) manager. Một máy có thể song song nhiều phiên bản rustc, mỗi project chọn một phiên bản riêng. Đây là cách chuẩn để cài và cập nhật Rust, không nên cài bằng apt, brew hệ thống (thường version cũ và không quản lý được component).

3 channel release:

• stable — phát hành mỗi 6 tuần đều như đồng hồ. Dùng cho production. Mặc định của rustup.
• beta — bản trước stable một chu kỳ, dành để kiểm tra dự án trước khi version mới ra mắt chính thức.
• nightly — build mỗi ngày, mở các feature gate chưa stable (specialization, một số GAT, asm! cũ, lint chưa stabilize). Cần thiết cho crate "frontier" nhưng không khuyến nghị cho service production.

Quản lý cơ bản:

rustup default stable
rustup update
rustup show

rustup install nightly
rustup override set nightly       # chỉ áp dụng cho thư mục hiện tại
cargo +nightly build              # ad-hoc dùng nightly cho 1 lệnh

rustup component add clippy rustfmt rust-analyzer
rustup target add wasm32-unknown-unknown aarch64-unknown-linux-gnu

Component là phần mở rộng của toolchain: clippy (linter), rustfmt (formatter), rust-analyzer (Language Server Protocol), llvm-tools-preview (cho coverage, profile). Cài qua rustup component add.

Target là kiến trúc / OS mà bạn cross-compile sang. rustup hiện hỗ trợ 90+ target triple, bao gồm WASM (browser, Cloudflare Workers), aarch64 Linux (server ARM, Apple Silicon), armv7 (Raspberry Pi), thumbv7em-none (embedded ARM Cortex-M), riscv64gc, mips, x86_64-pc-windows-gnu. Cross-compile từ macOS sang Linux aarch64 không phải pháp thuật — chỉ là rustup target add rồi cargo build --target ....

Bộ tool quanh Cargo là một trong những lý do dev khen Rust nhất, bất kể quan điểm về ownership thế nào:

• rustfmt — formatter chính thức. Một style duy nhất cho toàn cộng đồng. Không có "tabs vs spaces war", không có "single quote vs double quote". Chạy cargo fmt trước khi commit. Idiom mặc định.
• clippy — linter chính thức của rust-lang. Hơn 700 lint chia thành nhóm correctness (bug thật sự), suspicious, style, complexity, perf, pedantic. Chạy cargo clippy --all-targets -- -D warnings trong CI là pattern phổ biến.
• rust-analyzer — Language Server Protocol cho Rust, fork từ "RLS" cũ, được Rust Foundation nhận làm chính thức. Hover, go-to-definition, refactor rename, inlay hint, run/debug code lens. Mọi IDE đứng đắn (VS Code, Neovim, Helix, Zed, RustRover bản built-in riêng) đều dùng.
• cargo check — typecheck nhanh hơn build vài lần vì bỏ qua codegen. Dùng trong vòng lặp lưu-file-kiểm-lỗi.
• cargo test — chạy unit test (#[test] trong cùng file), integration test (tests/), doc test (code block trong ///). Một lệnh chạy hết.
• cargo bench — micro-benchmark (yêu cầu nightly cho built-in, hoặc crate criterion trên stable).
• cargo expand — mở rộng macro để xem code thực sự được sinh ra. Cứu cánh khi debug derive hoặc macro phức tạp.
• cargo audit — quét dependency tìm lỗ hổng đã công bố (RustSec advisory database).
• cargo deny — kiểm tra license, duplicate dependency, banned crate theo policy của team.

Khác biệt văn hoá: trong Rust, hỏi "tôi nên dùng linter nào, formatter nào, build tool nào?" thường nhận đáp án "clippy, rustfmt, cargo — không có lựa chọn khác cần cân nhắc". Tiết kiệm hàng ngày họp bàn config tooling cho team mới.

Rust Foundation được thành lập ngày 8/2/2021 như tổ chức phi lợi nhuận độc lập, tách khỏi Mozilla (nơi từng là sponsor chính của Rust giai đoạn 2010–2020). Mục tiêu: bảo trợ ngôn ngữ, ecosystem và community ở mức tổ chức, không phụ thuộc vào một corporation duy nhất.

5 founding member ban đầu: AWS, Google, Huawei, Microsoft, Mozilla. Đến năm 2026, số corp member đã vượt 30, gồm cả Toyota, JFrog, Meta, Arm, ZTE, Shopify, Dropbox, OpenAI và nhiều bên khác. Mỗi tier member đóng góp tài chính khác nhau, đổi lại có ghế bầu hội đồng quản trị (board) hoặc tiếng nói trong các technical advisory board.

Vai trò cụ thể của Foundation:

• Fund maintainer — chương trình Fellowship trả lương full-time cho một số maintainer cốt lõi để họ làm Rust như công việc chính, không phụ thuộc hảo tâm sponsor riêng lẻ.
• Hạ tầng — host crates.io, docs.rs, CI cho rust-lang, đăng ký domain, bảo mật chuỗi cung ứng (chương trình Security Initiative).
• Kiểm soát thương hiệu — sở hữu logo, tên "Rust", quy định trademark policy. Bạn dùng từ "Rust" trong tên sản phẩm thương mại phải tuân thủ guideline (vd: không gọi là "Rust IDE official" nếu không được cấp phép).
• Đại diện pháp lý — ký hợp đồng, nhận donation, bảo vệ project khỏi tranh chấp IP.
• Tổ chức sự kiện — RustConf, RustNation, hỗ trợ meetup cộng đồng.

Quan trọng: Foundation không quyết định technical direction của Rust. Mọi quyết định ngôn ngữ vẫn theo quy trình RFC + Project Teams (lang, libs, compiler, infra, dev-tools, moderation...). Foundation lo phần "tổ chức và tài chính" để team kỹ thuật chuyên tâm phần "ngôn ngữ".

Khi gặp bug khó, không hiểu lỗi compiler, hoặc cần feedback design, đây là các kênh đáng tham gia:

• Reddit r/rust — subreddit lớn nhất, ~350k thành viên, thread thảo luận hằng ngày. Phù hợp hỏi nhanh, đọc news, theo dõi release ghi chú.
• Rust Discord — server chính thức, có kênh #beginners, #help, #async, #embedded, #game-dev... Phản hồi nhanh hơn forum, không khí thoải mái.
• Rust Users Forum (users.rust-lang.org) — diễn đàn Discourse cho người dùng, câu hỏi có chiều sâu, lưu trữ tốt cho tìm kiếm Google.
• Rust Internals (internals.rust-lang.org) — diễn đàn cho thảo luận thiết kế ngôn ngữ, pre-RFC. Không phải nơi hỏi "code này sao lỗi".
• This Week In Rust — newsletter phát hành mỗi thứ ba từ năm 2014, tổng hợp release ghi chú, blog post hay, project mới, "Crate of the Week", call for participation. Cách hiệu quả nhất để bắt nhịp ecosystem chỉ với 15 phút mỗi tuần.
• Zulip — chat platform của Rust Project teams (compiler, lang...). Mở public, đọc được thảo luận thiết kế thật.
• RustConf — hội nghị thường niên (online + offline), talk được upload YouTube. RustNation UK, Rust Belt Rust, EuroRust là các sự kiện khu vực.
• Awesome Rust trên GitHub — danh sách crate được curate theo domain, điểm khởi đầu khi tìm tool cho domain mới.

Code of Conduct được áp dụng cứng rắn ở mọi kênh chính thức. Cộng đồng Rust được đánh giá là thân thiện với người mới — một phần nhờ moderation team chủ động và văn hoá "đọc compiler error trước khi hỏi" được khuyến khích.

150k crate là rất nhiều và rất dễ lạc. Đây là danh sách "default choice" theo từng domain backend tính đến giữa 2026 — chọn các tên này trước, đổi sau nếu có lý do:

• Web framework: axum (Tokio team, built trên hyper + tower, hiện là mặc định khuyến nghị), actix-web (kỳ cựu, throughput cao), rocket (focus ergonomics).
• Async runtime: tokio (de-facto standard, ecosystem khổng lồ). Đối thủ smol, async-std tồn tại nhưng chỉ nên chọn khi có lý do cụ thể.
• Serialization: serde + serde_json cho JSON, serde_yaml / toml cho config, bincode / rmp-serde (MessagePack) cho binary. Serde là chuẩn không có đối thủ.
• Database: sqlx (async, compile-time SQL check qua macro), diesel (sync, ORM với typed query builder), sea-orm (async ORM trên sqlx). Driver riêng: tokio-postgres, rusqlite, mongodb, redis.
• HTTP client: reqwest (high-level, dễ dùng), hyper (low-level), ureq (sync, không cần tokio).
• CLI: clap (parser argument, derive macro mạnh), indicatif (progress bar), console (color/style terminal), dialoguer (prompt tương tác).
• Logging / tracing: tracing + tracing-subscriber (structured, span-aware, chuẩn cho async). log cũ hơn nhưng vẫn dùng nhiều ở library.
• Error handling: anyhow cho binary (universal error, có context), thiserror cho library (derive macro tạo error type chuẩn). Hai crate này phối hợp tốt với nhau.
• UUID / time / regex: uuid, chrono hoặc time, regex. Mỗi cái gần như độc quyền domain của nó.
• Test: built-in đủ cho 90% trường hợp; thêm insta (snapshot test), mockall (mock), proptest (property-based), criterion (bench).

Một backend Rust 2026 điển hình thường có stack: axum + tokio + serde + sqlx + tracing + anyhow/thiserror + clap (nếu có CLI admin). Bạn sẽ gặp lại các crate này trong series Rust RESTful API.

• Cargo là build system + package manager + test runner + doc generator + lint runner tích hợp, thay thế cả npm + ESLint + Prettier + Jest + tsc của hệ JavaScript.
• crates.io là registry chính thức, ~150k crate năm 2026, version theo SemVer caret, không xoá được phiên bản đã publish (chỉ yank).
• docs.rs auto build API doc cho mọi bản publish, version-specific, có source link và feature flag rõ ràng.
• rustup quản lý 3 channel (stable / beta / nightly), 90+ target cross-compile, component chuẩn như clippy / rustfmt / rust-analyzer.
• Tooling chính thức: rustfmt (format), clippy (lint 700+ rule), rust-analyzer (LSP), cargo check / test / doc / bench / expand / audit.
• Rust Foundation thành lập 8/2/2021, độc lập Mozilla, 5 founding member ban đầu, nay >30 corp member, fund maintainer và kiểm soát thương hiệu — không quyết định technical.
• Community: r/rust, Discord, Users Forum, This Week In Rust (mỗi thứ ba từ 2014), RustConf.
• Stack backend mặc định 2026: axum + tokio + serde + sqlx + tracing + anyhow/thiserror.

Tự trả lời, đáp án ở cuối:

1. Khi nói "Cargo là all-in-one", liệt kê 5 trách nhiệm cụ thể của Cargo và tool tương đương phải dùng nếu làm việc tương tự trong project Node.js.
2. Một crate đã publish bị phát hiện có bug bảo mật nghiêm trọng. Maintainer có thể xoá hẳn version đó khỏi crates.io không? Cơ chế nào được dùng thay cho việc xoá?
3. URL docs.rs/serde/1.0.210 và docs.rs/serde/latest khác nhau thế nào? Khi tra cứu trong dự án production, nên dùng URL nào?
4. Bạn cần build một binary cho Raspberry Pi (aarch64-linux) từ máy macOS Apple Silicon. Liệt kê lệnh rustup + cargo cần thiết.
5. Phân biệt vai trò của Rust Project (team kỹ thuật) và Rust Foundation. Quyết định "thêm syntax mới vào ngôn ngữ" thuộc bên nào?

Bài 8: Use Case Thực Tế Của Rust Năm 2026 — đi qua các case study production: Linux kernel (Rust-for-Linux), Windows kernel module, Firefox/Servo, Discord, Cloudflare Pingora, AWS Firecracker, Dropbox Magic Pocket, Polkadot. Cuối bài là roadmap chuyển tiếp sang series Rust RESTful API.