在 Swift 宏体系中，BodyMacro 是一种专门用于替换方法体实现的宏协议。通过 BodyMacro，开发者可以为已有方法、构造器等提供新的实现代码，减少重复代码的书写，并将功能逻辑更加灵活地

Swift 宏系统中，MemberAttributeMacro 是一种用于为类型中的成员声明自动附加属性标记的宏。它适用于需要为多个成员统一附加如 @available、@objc、@discarda

在 Swift 宏系统中，ExtensionMacro 是一种用于自动生成扩展（extension）代码块的宏协议，适用于为类型生成协议实现、工具方法、便捷功能等 “类型之外”的附加内容。它是 Swi

在 Swift 宏体系中，AccessorMacro 是一种专用于自动生成属性访问器（如 getter、setter、willSet、didSet 等） 的宏协议。它适用于那些希望对属性访问行为进行自

在 Swift 宏体系中，PeerMacro 是一种非常灵活且强大的宏协议，专用于生成与绑定声明处于同一作用域的“对等”声明，常用于自动扩展同级的变量、函数或类型定义。 本节将深入介绍 PeerMac

在 Swift 中，结构体和类的声明体（即 {} 中的内容）常常会包含许多重复或模式化的成员声明。为了提升开发效率并避免重复劳动，Swift 宏系统提供了一种用于自动生成成员声明的宏协议：Member

在 Swift 宏体系中，DeclarationMacro 是一种用途广泛的角色，专门用于生成声明级别的代码，如变量、函数、结构体等。它同样属于自由悬挂宏（freestanding macro）的一种

在 Swift 宏体系中，ExpressionMacro 是一种非常重要且常用的角色。它专门用于生成表达式级别的代码，并且属于独立宏（freestanding macro） 的一种。 本节将深入讲解

Swift 宏的强大源于其背后一套精巧严谨的协议体系。这些协议定义了： 宏的行为规范：如何与编译器通信，如何生成语法树 宏的能力边界：什么宏可以插入什么样的结构 宏的输入输出约束：需要接受什么样的输入

在编写 Swift 宏时，你将频繁与 SwiftSyntax 打交道。SwiftSyntax 将源码拆解为结构化的语法节点（Syntax）树，这些节点覆盖了表达式、声明、语句、类型、模式、属性等各个层

在正式深入宏的世界之前，我们必须理解一个核心概念：Syntax（语法节点） 。它不仅是 Swift 宏生成和操作代码的“原材料”，更是编译器理解代码结构的基础。 语法树(Syntax Tree) 是代

在 Swift 宏系统中，宏类型（Macro Kind） 、宏角色（Macro Role） 与命名说明符（Name Specifier） 共同决定了宏的使用范围和生成内容的可控性。 宏类型 决定宏的附

1. 宏的定义 Swift 宏（Macro） 是一种在编译期执行的代码生成机制。开发者可以通过简洁的语法标记，在源代码中自动插入、替换或补充逻辑，从而实现样板代码的自动化。 Swift 宏建立在语法树

Swift 宏（Macro）对许多开发者来说，是一种既熟悉又陌生的工具。在 Objective-C 时代，我们经常使用 #define、条件编译、日志封装，甚至自动插桩来提升开发效率。这些基于 C 的

基础篇 Swift Macros - 宏之起点 本文介绍了 Swift 宏 的背景与引入动机，阐述了宏在编程中的基本用途，帮助开发者理解宏如何简化代码编写、提升开发效率。内容还包括了宏的基本配置方式与