企业官网建设流程全解析

SwiftUI-Agent-Skill（技能名 SwiftUI Pro）是一个面向 Claude Code、Codex、Gemini 等 AI 编程助手的 SwiftUI 技能包，帮助新手和普通开发者写出更现代、更高性能的 SwiftUI 代码。它内置了一条容易被忽视的SwiftUI 状态管理高级技巧：把 CIContext 这类昂贵对象存进 @State，用状态即缓存的思路免去重复创建的性能开销。这篇指南带你拆解它的原理、边界和正确用法。

5分钟安装：SwiftUI Pro技能包怎么装？

项目遵循标准的 Agent Skills 格式，安装只需一步，把仓库克隆下来交给你的 AI 助手即可：

git clone https://gitcode.com/GitHub_Trending/swi/SwiftUI-Agent-Skill

技能入口文件是 SKILL.md，在 Claude Code 中输入/swiftui-pro、在 Codex 中输入$swiftui-pro即可触发审查，也支持自然语言指令，比如"用 SwiftUI Pro 技能帮我查这个项目里的性能问题"。完整的安装与使用说明见 README.md。

什么是"状态即缓存"？为什么是CIContext？

先说常识：@State通常用来存Int、Bool、数组这类需要驱动界面刷新的小数据。但 SwiftUI-Agent-Skill 在数据流规则中明确指出——当视图持有一个包含"昂贵重建数据"的类实例（例如 Core Image 的CIContext）时，可以用@State来保存它，即使它根本不是可观察对象。

这条规则出自 references/data.md 的 Local state 一节。

为什么偏偏点名 CIContext？因为它底层会初始化 Metal 图形设备、GPU 资源等系统级对象，创建成本极高。如果你的渲染函数每次被调用都新建一个 CIContext，图片滤镜、照片编辑类功能会明显卡顿。而CIContext本身是无状态的"渲染器"，创建一次后完全可以长期复用——这就是它最适合作为"缓存对象"的原因。

💡 同一思路还适用于其他"创建慢、内容不变"的重型对象：字体缓存、解码器、几何变换管线等。判断标准只有一个——重建代价高 + 实例无状态（或状态独立于界面）。

原理拆解：@State凭什么能当缓存用？

理解这个技巧，关键在于分清@State的两项能力：

换句话说，@State在这里充当的是一个"挂在视图结构上的稳定容器"：SwiftUI 保证它在视图身份存续期间不重建对象，但不需要它对变化做任何响应。

对比两种写法的差别：

// ❌ 每次渲染都新建 CIContext，GPU 资源反复初始化 func render() { let ctx = CIContext(options: []) // ... 使用 ctx 渲染 } // ✅ 用 @State 把 CIContext 存成"缓存"，只创建一次 @State private var context: CIContext?

注意第二个写法里@State标记为private——这正是 data.md 中的配套规则：@State 应始终 private，且只由创建它的视图持有。缓存对象不外泄，是这套技巧能保持简单的前提。

避坑指南：@State缓存的边界与失效管理

技巧好用，但有一条红线必须记住。references/performance.md 的性能规则写道：

优先用let从可信数据源派生转换结果，或缓存到@State；但把派生的集合缓存在@State里时，必须自己实现显式的失效逻辑，否则界面会显示过期数据。

翻译成新手能懂的三句话：

1. 🔒只缓存"无状态的重型对象"（CIContext 这类）。它们的值永不"过期"，天然安全。
2. ⚠️缓存"派生数据"（如过滤后的列表、排序结果）要格外小心——源数据变了缓存不会自动跟着变，必须手动写失效逻辑，宁可不用这个技巧。
3. 🧹视图销毁即自动清理：@State的生命周期跟随视图，不需要手动释放，比全局单例缓存干净得多。

让AI帮你审查：状态与缓存代码怎么查？

SwiftUI-Agent-Skill 把这类经验固化成了可执行的审查清单，覆盖 9 个维度，核心入口定义在 skills/swiftui-pro/SKILL.md，审查流程按以下参考文件逐项执行：

• data.md — 数据流、共享状态、属性包装器（本技巧所在）
• performance.md — 性能优化与缓存失效检查
• views.md — 视图结构、组合与动画
• api.md — 现代 API 与废弃写法替换
• navigation.md — 导航与弹层
• accessibility.md — VoiceOver、Dynamic Type 等无障碍合规
• swift.md — 现代 Swift 与并发写法
• design.md — 符合 HIG 的设计规范
• hygiene.md — 代码整洁度终检

审查输出会按文件分组，逐条给出"行号 + 违反的规则 + 修改前后对比"，新手照着改即可。

小结

"状态即缓存"是 SwiftUI-Agent-Skill 里一个成本极低、收益极高的高级技巧：用@State的持久化能力免费托管一个昂贵但无状态的对象（如 CIContext），既避免了重复创建的性能损耗，又不用引入全局缓存的复杂度。记住那条边界——派生集合缓存必须自带失效逻辑——你就能放心地在项目里运用它。装上 SwiftUI Pro，让 AI 助手替你守住这些细节吧 ✅