基础篇
Swift Macros - 宏之起点
本文介绍了 Swift 宏 的背景与引入动机,阐述了宏在编程中的基本用途,帮助开发者理解宏如何简化代码编写、提升开发效率。内容还包括了宏的基本配置方式与使用场景,适合入门读者对宏有一个初步的了解。
Swift Macros - 宏之全貌
这篇文章从宏的类型体系、执行原理到角色机制和协议模型,为读者提供了一个宏系统的全景鸟瞰。文章介绍了宏在 Swift 中的不同角色及其协议关系,阐述了宏的扩展、展开过程以及如何结合协议实现多角色配合,帮助有一定基础的开发者全面理解宏的设计和应用。
Swift Macros - 宏之职责与命名
本篇文章聚焦 Swift 宏系统中的“职责控制”与“命名控制”机制,系统讲解宏的三大核心组成:宏类型(Macro Kind) 、宏角色(Macro Role) 和 命名说明符(Name Specifier) 。通过区分独立宏与绑定宏、梳理各类宏角色,并结合命名说明符的使用方式,帮助开发者构建更清晰、稳定、可维护的宏能力体系。
Swift Macros - 宏之语法树
本篇文章聚焦 Swift 宏系统中的“语法基础”与“结构操控”能力,深入剖析宏所操作的核心结构——语法节点(Syntax) 。通过讲解 SwiftSyntax 的节点体系、语法树的提取与构造方式、以及 (raw:) 插值的正确用法,帮助开发者掌握宏展开背后的语法逻辑与生成原理,为构建结构化、类型安全的宏能力奠定坚实基础。
Swift Macros - 宏之节点指南
本文梳理了 SwiftSyntax 中常用的语法节点,涵盖表达式、声明、语句、类型、模式、属性、宏以及其他常用节点。每个节点均提供简要描述和快速构造示例,旨在为开发者在使用 Swift 宏和 SwiftSyntax 进行代码生成、分析和转换时,提供一份高效、准确的参考资料。
Swift Macros - 宏之协议
Swift 宏系统通过不同的协议定义了宏的多种角色和能力,从表达式生成、声明插入,到成员绑定、访问控制等。本系列文章将逐个讲解这些协议的定义、特性及适用场景,帮助你系统理解宏的角色体系。
1.宏协议概述
简要介绍 Swift 中所有宏协议的概念、作用及它们之间的关系,作为理解整个宏协议体系的入口。 查看详情
2.表达式独立宏(ExpressionMacro)
讲解 ExpressionMacro 协议的定义与使用场景,展示如何基于表达式节点生成动态代码。
3.声明式独立宏(DeclarationMacro)
分析 DeclarationMacro 如何生成声明代码,结合初始化器、变量、函数的实际生成场景讲解。
4.成员绑定宏(MemberMacro)
展示 MemberMacro 如何为结构体或类动态插入属性、方法等成员内容,是构建派生代码的核心手段。
5.对等绑定宏(PeerMacro)
说明 PeerMacro 的用途,即在同一层级下生成兄弟声明,常用于生成辅助类型或伴生属性等。
6.访问器宏(AccessorMacro)
讲解 AccessorMacro 如何为现有的属性生成 getter/setter 等访问逻辑,结合 UserDefault 等场景展开。
7.扩展宏(ExtensionMacro)
展示 ExtensionMacro 用于生成扩展声明,实现协议适配、默认实现等功能。
8.属性宏(MemberAttributeMacro)
讲解 MemberAttributeMacro 的应用,如为属性自动添加注解、权限、内联标识等修饰语。
9.方法体宏(BodyMacro)
说明 BodyMacro 的设计方式,以及如何为已有函数添加函数体代码,常用于方法插桩与默认实现生成。