Mikor indokolt több crate?

A workspace akkor segít, ha több csomag együtt változik, mégis világos határt szeretnél közöttük. A példánkban egy könyvtár névlistákat dolgoz fel, a CLI pedig bemenetet fogad és kiírja az eredményt. A könyvtár nem ismeri a parancssort; így később egy másik bináris is felhasználhatja. Egy kétszáz soros program felosztása önmagában még nem javítja a karbantarthatóságot: először a külön felelősségeket nevezd meg.

Ez a cikk a korábbi workspace-bevezetők összevont, 2026-ban átdolgozott változata. Az eredeti megjelenési dátumot megtartjuk, az itt tárgyalt konfiguráció a frissítéshez tartozik. A Cargo alapműveleteit a build, run, test leckében gyakorolhatod, az adatátadás tervezéséhez pedig az ownership leckét ajánljuk.

A gyökér koordinál, a csomagok fordulnak

A kísérő példában a gyökér Cargo.toml virtuális workspace-t ír le. A két tag a core és a cli mappában található. A függőség iránya egyértelmű: a CLI függ a könyvtártól, a könyvtár nem függ a CLI-től. A Cargo workspace referencia részletezi a tagságot, az örökölt csomagmezőket és a közös függőségdeklarációkat.

[workspace]
members = ["core", "cli"]
resolver = "3"

[workspace.package]
edition = "2024"
version = "0.1.0"

[workspace.dependencies]
nevjegy-core = { path = "core" }

A közös deklaráció nem tesz minden függőséget automatikusan minden tag függőségévé. Az érintett csomag manifestjében továbbra is kérni kell az öröklést. Ez előny: a manifestből látszik, hogy a csomag mit használ. A közös verziókezelés nem azonos azzal, hogy minden csomagnak ugyanazt az API-t vagy kiadási ritmust kell követnie.

Ellenőrizz csomagot és teljes workspace-t is

Fejlesztés közben gyors lehet egyetlen tag tesztjét futtatni, de változtatás előtt és után a teljes összeállítást is ellenőrizd. A cargo test dokumentációja bemutatja a csomagkiválasztást. Egy megosztott könyvtár módosítása a saját egységtesztje mellett a fogyasztó programot is érintheti.

cargo test --workspace --locked
cargo run -p nevjegy-cli --locked
cargo metadata --no-deps --format-version 1

A cargo metadata hasznos ellenőrzőpont automatizálásnál: a tényleges csomagkapcsolatot nézd, ne a mappanevekből következtess. A release eljárásban a kívánt csomagot nevezd meg; a repo valamelyik almappájában kiadott parancs alapértelmezett viselkedése könnyen eltérhet a gyökérből futtatottétól.

Kerüld a láthatatlan összekapcsolást

Ha két könyvtár kölcsönösen igényelné egymást, gyakran egy harmadik, közös adatmodell vagy rosszul megválasztott felelősséghatár áll a háttérben. A workspace nem oldja fel a ciklikus függőséget. Ugyanígy a megosztott target könyvtár nem garantál minden változtatásnál gyorsabb buildet; teljesítményállításhoz saját mérés kell.

A Cargo features útmutatója különösen fontos, ha opcionális képességeket kezdesz használni. A tesztelt feature-kombinációkat rögzítsd a CI-ban. A kísérő projekt Rust 1.97.1, edition 2024 alatt ellenőrizhető: a könyvtárnak üres és ékezetes bemenetre is van tesztje, a CLI pedig valóban ezt a könyvtárat hívja. Így a felosztás előnye nem csak a könyvtárstruktúra ábráján látszik.