01-示例宏

Tue, 18 Aug 2026 08:45:00 +0800

译文 · 基于 The Rust Reference

原文链接: https://doc.rust-lang.org/reference/macros-by-example.html

r[macro.decl]

示例宏

r[macro.decl.syntax]

MacroRulesDefinition ->
 `macro_rules` `!` IDENTIFIER MacroRulesDef

MacroRulesDef ->
 `(` MacroRules `)` `;`
 | `[` MacroRules `]` `;`
 | `{` MacroRules `}`

MacroRules ->
 MacroRule ( `;` MacroRule )* `;`?

MacroRule ->
 MacroMatcher `=>` MacroTranscriber

MacroMatcher ->
 `(` MacroMatch* `)`
 | `[` MacroMatch* `]`
 | `{` MacroMatch* `}`

MacroMatch ->
 Token _except `$` and [delimiters][lex.token.delim]_
 | MacroMatcher
 | `$` ( IDENTIFIER_OR_KEYWORD _except `crate`_ | RAW_IDENTIFIER ) `:` MacroFragSpec
 | `$` `(` MacroMatch+ `)` MacroRepSep? MacroRepOp

MacroFragSpec ->
 `block` | `expr` | `expr_2021` | `ident` | `item` | `lifetime` | `literal`
 | `meta` | `pat` | `pat_param` | `path` | `stmt` | `tt` | `ty` | `vis`

MacroRepSep -> Token _except [delimiters][lex.token.delim] and [MacroRepOp]_

MacroRepOp -> `*` | `+` | `?`

MacroTranscriber -> DelimTokenTree

r[macro.decl.intro] macro_rules 允许用户以声明式方式定义语法扩展。我们称此类扩展为“示例宏”（macros by example），或简称“宏”。

02-过程宏

Tue, 18 Aug 2026 08:45:00 +0800

译文 · 基于 The Rust Reference

原文链接: https://doc.rust-lang.org/reference/procedural-macros.html

r[macro.proc]

过程宏

r[macro.proc.intro] 过程宏 允许以执行函数的方式创建语法扩展。过程宏有三种风格：

函数式宏 - custom!(...)
Derive 宏 - #[derive(CustomDerive)]
属性宏 - #[CustomAttribute]

过程宏允许你在编译期运行对 Rust 语法进行操作的代码，既消费也产生 Rust 语法。你可以大致把过程宏想成从一份 AST 到另一份 AST 的函数。

第3章 宏 on 编程那些事儿

01-示例宏

示例宏

02-过程宏

过程宏

第3章宏 on 编程那些事儿