Antwort

Das Modulsystem in Rust basiert auf dem Schlüsselwort mod. Module ermöglichen es, den Code logisch in Dateien und Namensräume zu unterteilen. Wichtige Punkte:

• Alles ist standardmäßig privat (private) innerhalb des aktuellen Moduls.
• pub macht ein Element öffentlich für den gesamten Modulbaum.
• pub(crate) ist im gesamten crate (d.h. Bibliothek/Projekt) zugänglich.
• Namenskonflikte werden durch Namensräume gelöst: durch explizites Importieren (use mod_name::item) und Aliase.

Für große Projekte wird empfohlen, eine Modulstruktur mit öffentlichen Schnittstellen nur über lib.rs oder main.rs zu verwenden, alles andere bleibt privat:

mod netzwerk;
mod speicher;
pub use netzwerk::api;

Fangfrage

Wenn eine Struktur als pub deklariert ist, wird sie für andere crates zugänglich?

Antwort: Nein, es reicht nicht aus, die Struktur als pub zu kennzeichnen. Sie muss auch in einem Modul deklariert sein, das für externe crates geöffnet ist (pub mod), und die Felder der Struktur müssen public sein, um direkten Zugriff zu ermöglichen.

Beispiel:

mod foo { pub struct Bar; }
// Bar ist außerhalb des crate nicht sichtbar, da foo — privat

Beispiele für reale Fehler aufgrund mangelnden Wissens über die Feinheiten des Themas

---

Geschichte

In einem Projekt mit einer komplexen Modulse Struktur wurde versehentlich eine Struktur als pub deklariert, aber das Modul nicht als pub exportiert. Später, als versucht wurde, die Struktur aus einem anderen crate zu verwenden, gab es einen Fehler wegen der Unzugänglichkeit des Typs.

Geschichte

In einer großen Bibliothek exportierten verschiedene Module dieselben Namen (z.B. types und errors). Bei blindem Gebrauch von use * entstanden Namenskonflikte zur Compile-Zeit. Die Lösung war das Hinzufügen von Aliasen und das Importieren nur der benötigten Elemente.

Geschichte

Viele Anfänger erstellen eine pub-Struktur, lassen jedoch die Felder privat, was die Initialisierung außerhalb des Moduls unmöglich macht. Infolgedessen konnte eine Funktion aus einem anderen Modul die Struktur nicht direkt erstellen, was Fehler verursachte, bis die Felder oder Konstruktoren öffentlich gemacht wurden.