Makros importieren & beyond macro_rules!
Lektion 6 von 7
Makros exportieren und importieren
Ein mit macro_rules! definiertes Makro ist ab seiner Definition im selben
Modul sichtbar. Um es nach außen zu geben, schreibt man #[macro_export]:
// lib.rs
#[macro_export]
macro_rules! drucke {
($($arg:expr),*) => {
$(println!("{arg}");)*
};
}
Mit #[macro_export] landet das Makro auf der Crate-Root und ist für
Außenstehende unter meine_crate::drucke! erreichbar. Innerhalb einer Crate
verwendet use crate::... (bzw. use meine_crate::drucke im Crate-Grenzfall
#[macro_use]).
Debugging: trace_macros! und log_syntax!
Makros sind oft schwer zu debuggen, weil man die expandierte Form nicht sieht. Nightly bietet zwei experimentelle Helfer:
trace_macros!(true)— druckt jede Makro-Expansionlog_syntax!()— druckt die Argumente, ohne zu expandierencargo expand(externes Tool) — zeigt den voll expandierten Code
Beyond macro_rules!: Prozedurale Makros
Neben den deklarativen macro_rules!-Makros gibt es prozedurale Makros
(Prozeduren, die zur Compile-Zeit laufen und Tokens transformieren):
#[derive(...)]— kann z. B.DebugoderCloneautomatisch generieren- Attribute-Makros — wie
#[test]oder Web-Router-Annotationen - Funktionsähnliche Makros — wie
macro_rules!, aber mit vollem Code
derive(Serialize), derive(Deserialize) in Serde oder #[tokio::main] sind
bekannte prozedurale Makros aus der Praxis.
Wann Makro, wann Funktion?
Faustregel: Funktion, wenn möglich. Makros erhöhen Komplexität, sind
typischerweise nur lokal sichtbar und schwerer zu debuggen. Greif zu einem
Makro, wenn du echte Metaprogrammierung brauchst: Listen-Syntax erzeugen,
Boilerplate generieren (derive), oder Lazy Evaluation verlangen. Sonst: eine
normale Funktion ist einfacher, lesbarer und testbar.
⚠ Häufiger Fehler:
#[macro_export]exportiert an den Crate-Root, nicht in das Modul, in dem das Makro definiert wurde —use meine_lib::utils::drucke;scheitert mit „unresolved import“. Richtig istuse meine_lib::drucke;, denn genau dort liegt das Makro für Außenstehende.
✅ Wichtige Erkenntnisse
Haken setzen, um deinen Lernfortschritt zu markieren:
Rufe dir die Kernpunkte in Erinnerung, bevor du die Liste aufdeckst.
Erinnerungstraining
Tippe den fehlenden Begriff aus dem Gedächtnis ein und prüfe.