Skip to content
Modul 19 — Makros: Code schreiben, der Code schreibt
6

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-Expansion
  • log_syntax!() — druckt die Argumente, ohne zu expandieren
  • cargo 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. Debug oder Clone automatisch 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 ist use meine_lib::drucke;, denn genau dort liegt das Makro für Außenstehende.

✅ Wichtige Erkenntnisse

0/3

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.

Mit dem Attribut landet ein Makro auf der Crate-Root und ist von außen als meine_crate::drucke! erreichbar.
(externes Tool) zeigt den voll expandierten Makro-Code — hilfreich, weil man die Expansion sonst nicht sieht.
Das prozedurale Makro generiert Trait-Implementierungen wie Debug oder Clone automatisch.
0 von 3 richtig

This site uses essential cookies for Stripe payments. No tracking cookies.