预览与 Preview Provider
使用 #Preview 和 PreviewProvider 在 Xcode 中即时查看变化。
预览与 Preview Provider 是 CoddyKit 上的免费 Swift Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Swift Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Swift Academy 课程共包含 4 节课。
欢迎
Xcode 预览让您无需启动模拟器就能立即查看 SwiftUI 的变化。预览可以使用 `#Preview`（Swift 5.9+）或 `PreviewProvider` 定义。
#Preview 宏（Swift 5.9+）
```swift
#Preview {
ContentView()
}
```
这是最简单的预览定义，只需一行代码。Xcode 会在画布中渲染它。
PreviewProvider（旧式写法）
```swift
struct ContentView_Previews: PreviewProvider {
static var previews: some View {
ContentView()
}
}
```
多个预览
```swift
#Preview("Dark Mode") {
ContentView().preferredColorScheme(.dark)
}
#Preview("iPad") {
ContentView().previewDevice("iPad Air (5th generation)")
}
```
提供示例数据
```swift
#Preview {
let model = ViewModel()
model.items = ["One","Two","Three"]
return ListView(model: model)
}
```
previewDisplayName
```swift
struct Previews: PreviewProvider {
static var previews: some View {
Group {
ContentView().previewDisplayName("Light")
ContentView().preferredColorScheme(.dark).previewDisplayName("Dark")
}
}
}
```
预览中的环境
```swift
#Preview {
ContentView()
.environment(\.locale, .init(identifier:"tr"))
.environment(\.sizeCategory, .accessibilityLarge)
}
```
预览中的 @EnvironmentObject
```swift
#Preview {
ContentView().environmentObject(AppModel())
}
```
预览性能提示
• 预览在独立进程中运行
• 保持预览数据轻量
• 将专用于预览的数据提取到 `extension PreviewProvider` 中
• 避免在预览代码中进行网络请求
实时预览
点击预览画布中的 ▶ 按钮即可启用实时预览——这是一种交互模式，按钮点击和文本字段输入都能实时生效。
快速检查
哪个 Swift 5.9+ 宏可以创建 SwiftUI 预览？
回顾
主要要点：
• `#Preview { }`——Swift 5.9+ 的单行预览
• `PreviewProvider`——较旧的基于协议的方式
• 使用不同的名称、设备和颜色方案创建多个预览
• 在预览中注入环境和 environmentObject
• 实时预览无需启动应用即可进行交互式测试
课程完成！接下来学习 SwiftUI 布局。
常见问题解答
「预览与 Preview Provider」课时是免费的吗？
是的 — 「预览与 Preview Provider」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Swift Academy 课程的其余内容，请升级到 CoddyKit PRO。 Swift Academy 课程共包含 4 节课。
「预览与 Preview Provider」这节课中我会学到什么？
使用 #Preview 和 PreviewProvider 在 Xcode 中即时查看变化。 你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Swift Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Swift Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「预览与 Preview Provider」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Swift Academy 课中编写并运行代码吗？
能。每节 Swift Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- View 协议与 body 属性
- @State：视图中的本地可变状态
- 视图修饰器：串联与自定义修饰器
- 预览与 Preview Provider