一、问题的引出

想象这样一个场景：你正在开发一个网络请求框架，每定义一个 API 接口。都要手动编写大量模板代码：

// 定义使用者接口
struct UserAPI {
// 需要手动写 URL
var url: String { "https://api.example.com/user" }
// 需要手动写请求方法
var method: HTTPMethod { .get }
// 需要手动写参数编码
var parameters:?{ nil }
// 需要手动写响应解析
func parse throws -> User {
return try JSONDecoder.decode
}
// 需要手动写错误处理
func handleError -> APIError {
return APIError.networkError
}
}

每个 API 都要重复这些模式，代码冗长且容易出错。当项目有几十个接口时维护成本急剧上升。

能不能让编译器自动生成这些代码？

这就引出了元编程的概念。

二、什么是元编程

定义

传统编程：开发者写代码 → 编译器编译 → 可执行程序
再看元编程。开发者写规则 → 代码生成器 → 生成代码 → 编译器编译 → 可执行程序

主要思想

元编程的主要是将重复的模式抽象为规则，让程序自动处理这些模式。其实，

比如上面的例子。我们只需要定义：

@API
struct UserAPI {
typealias Response = User
}

编译器就能自动生成所有实现代码。

元编程解决什么问题

三、Swift 中的元编程形式

- 泛型 最基本的元編譯形式,特定类型的代碼。swift // 編寫一次,編譯時為每個類型生成特化版本func swapValues { let temp = a a = b b = temp}var x =。 y = swapValues // 編譯時為Int類型生成swapValues{} - **反射** 運行時檢查類型的元數據。swift struct Person { let name: String let age: Int}let mirror = Mirror// 檢查屬性for child in mirror.children { print} 从**限制**来看。只讀,無法修改，怎么说呢，

• KeyPath 類型安全屬性訪問路徑。SwithUI 大量使用。swift struct Address{var city:String} struct Person{var address=Address} // KeyPath 本身就是類型let path=\Person.address.cityprint//北京
• Property Wrapper 為屬性添加統一邏輯。swift @propertyWrapper struct Capitalized{private var value=""var wrappedValue:String{ get{return value.capitalized} set{value=newValue}}} struct User{@Capitalized var name}var user=Userprint//Zhangsan
• Result Builder 構建聲明式DSL,SwithUI 的主要技術。swift @resultBuilder enum HTMLBuilder{}func html->String{}html{"\ufeff\ufeff"}

  Swift Macro

最新編譯時代碼生成功能。

分類

標記	功能描述
#stringify	轉字符串
#warning/#error	編譯時提示
#available	网站可用性檢查
#selector/#keyPath	安全選擇路徑
#fileID/#filePath	模塊文件標識

新增系統宏这方面，

自訂義Macro範例

日誌Macro

問題:日誌信息需要文件名+行號。

swift @freestanding public macro LogDebug->Void{

public struct LogMacro{ static func expansion->ExprSyntax{ return"""\ufeff\ufeff"""}}

至于使用。

三、總結

Swift 元編譯演進:

泛型→Protocol Extensions→KeyPaths→Property Wrappers→Result Builders→Macros

再看優勢，

✅減少樣板碼開銷 ✅強制約束與類型安全 ✅跨网站兼容

再看最佳實踐，

📌從小範圍實驗開始擴展使用場景 📌優先使用內置宏功能覆蓋需求