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.


