Swift Academy · 课时

用于减少样板代码的附加成员宏

Q: 「用于减少样板代码的附加成员宏」这节课中我会学到什么？

使用成员宏自动生成初始化器、CodingKeys 或 Equatable 一致性。 你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

使用成员宏自动生成初始化器、CodingKeys 或 Equatable 一致性。

用于减少样板代码的附加成员宏 是 CoddyKit 上的免费 Swift Academy 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Swift Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Swift Academy 课程共包含 4 节课。

成员宏概览

附加成员宏会直接在经过修饰的类型上生成新成员，包括属性、方法和初始化器。

@AddID
struct User { var name: String }
// After expansion:
// struct User { var name: String; var id = UUID() }

遵循 MemberMacro

实现MemberMacro，并返回一个DeclSyntax数组，用来表示新成员。

import SwiftSyntaxMacros

struct AddIDMacro: MemberMacro {
  static func expansion(
    of node: AttributeSyntax,
    providingMembersOf decl: some DeclGroupSyntax,
    in context: some MacroExpansionContext
  ) throws -> [DeclSyntax] {
    return ["var id = UUID()"]
  }
}

生成初始化器

成员宏可以生成自定义初始化器，并在需要时替代成员初始化器。

// Macro expansion returns:
[
  "init(name: String) { self.name = name; self.id = UUID() }"
]

@Observable 宏内部机制

Swift 内置的@Observable会使用成员宏为您的类添加观察基础设施。

@Observable
class Counter {
  var count = 0
  // macro adds: _$observationRegistrar, access(), withMutation()
}

读取经过修饰的类型

通过表示声明的参数访问经过修饰类型的属性，从而生成感知上下文的成员。

if let structDecl = decl.as(StructDeclSyntax.self) {
  let members = structDecl.memberBlock.members
  // iterate to inspect stored properties
}

提取存储属性

筛选成员列表，找出符合存储属性模式的变量声明，以驱动代码生成。

let storedProps = members.compactMap { member -> VariableDeclSyntax? in
  guard let varDecl = member.decl.as(VariableDeclSyntax.self),
        varDecl.bindingSpecifier.tokenKind == .keyword(.var)
  else { return nil }
  return varDecl
}

根据成员生成 Equatable

@AutoEquatable宏可以通过比较每个存储属性来生成==。

// Generated code:
static func == (lhs: User, rhs: User) -> Bool {
  lhs.name == rhs.name && lhs.id == rhs.id
}

结合成员宏与一致性宏

通常会将MemberMacro与ConformanceMacro配合使用，以同时添加成员并声明协议遵循。

struct AutoEquatableMacro: MemberMacro, ConformanceMacro { ... }

属性参数

您的宏可以接受参数，用于定制它所生成的代码。

@Clamped(range: 0...100)
var score: Int = 50
// macro reads range from attribute node and generates clamping accessors

宏错误报告

当宏使用不正确时，可以抛出MacroExpansionError或发出诊断信息。

guard decl.is(StructDeclSyntax.self) else {
  throw MacroError.message("@AddID can only be applied to structs")
}

构建性能

由于展开发生在编译时，成员宏不会产生运行时开销，并且生成的代码可以缓存。

// All generated members are emitted as source code
// and compiled normally — no reflection at runtime

快速检查

附加成员宏必须遵循哪个协议？

课程回顾

成员宏（MemberMacro）可以为其修饰的类型生成存储属性、计算属性和初始化器。读取类型已有的成员，可以生成与上下文相关的代码。结合ConformanceMacro还可以添加协议遵循。

常见问题解答

「用于减少样板代码的附加成员宏」课时是免费的吗？

是的 — 「用于减少样板代码的附加成员宏」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Swift Academy 课程的其余内容，请升级到 CoddyKit PRO。 Swift Academy 课程共包含 4 节课。

「用于减少样板代码的附加成员宏」这节课中我会学到什么？

使用成员宏自动生成初始化器、CodingKeys 或 Equatable 一致性。你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Swift Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Swift Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 4 节。

「用于减少样板代码的附加成员宏」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Swift Academy 课中编写并运行代码吗？

能。每节 Swift Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Swift Academy