Swift Composable Architecture (SCA) 框架在大型 SwiftUI 项目中的应用。针对传统 SwiftUI 状态管理混乱、副作用难控、测试困难等问题，文章阐述了组合式架构的设计哲学，通过会议管理系统案例展示了如何定义业务模型、构建功能模块及实现导航逻辑。重点讲解了使用 TestStore 进行单元测试和集成测试的策略，强调了模块化设计对提升代码可维护性、团队协作效率及性能优化的价值，为开发者提供了从单体到重构的架构演进参考。
从单体架构到模块化重构，这是一个关于技术决策与架构演进的真实故事。当我们团队接手一个已经迭代两年的 SwiftUI 项目时，代码库已经变得难以维护：状态分散在数十个@State 和@ObservedObject 中，网络请求与定时器操作难以追踪，UI 测试覆盖率几乎为零。
在项目初期，SwiftUI 的声明式语法确实带来了开发效率的提升。但随着业务复杂度增加，我们发现了三个致命问题：
状态管理失控
副作用难以控制
测试几乎不可能
组合式架构的核心思想是将复杂的应用拆分为可组合、可测试的小单元。每个功能模块包含完整的状态管理、业务逻辑和副作用处理。
架构核心：三要素模型
在深入技术细节前，让我们理解这个架构的哲学基础：
// 功能模块的完整定义
@Reducer struct FeatureModule {
@ObservableState struct State { /* 状态定义 */ }
enum Action { /* 所有可能的用户操作 */ }
var body: some Reducer<State, Action> {
// 纯函数处理状态转换
}
}
这种设计模式确保了：
让我们通过一个真实的案例——会议管理系统，来展示组合式架构的实际应用。
在构建任何界面之前，我们先定义数据模型：
struct SyncUp: Equatable, Identifiable {
let id: UUID
var title: String
var attendees: [Attendee]
var duration: Duration
}
每个功能模块都是自包含的单元：
@Reducer struct SyncUpsListFeature {
@ObservableState struct State {
var syncUps: IdentifiedArrayOf<SyncUp> = []
var isCreatingSyncUp = false
}
enum Action {
case addSyncUpButtonTapped
case deleteSyncUp(IndexSet)
case syncUpTapped(SyncUp)
}
// 减速器实现...
}
组合式架构的导航系统是其最强大的特性之一：
@Reducer struct AppFeature {
@ObservableState struct State {
var syncUpsList = SyncUpsListFeature.State()
var syncUpDetail: SyncUpDetailFeature.State?
}
enum Action {
case syncUpsList(SyncUpsListFeature.Action)
case syncUpDetail(SyncUpDetailFeature.Action)
}
var body: some Reducer<State, Action> {
Scope(state: \.syncUpsList, action: \.syncUpsList) {
SyncUpsListFeature()
}
// 更多作用域定义...
}
}
使用 TestStore 可以轻松验证状态变化：
func testAddingSyncUp() async {
let store = TestStore(initialState: AppFeature.State()) {
AppFeature()
}
await store.send(.syncUpsList(.addSyncUpButtonTapped)) {
$0.syncUpsList.isCreatingSyncUp = true
}
}
组合式架构的模块化特性使得集成测试变得简单：
func testNavigationFlow() async {
let store = TestStore(initialState: AppFeature.State()) {
AppFeature()
}
// 模拟用户点击添加会议按钮
await store.send(.syncUpsList(.addSyncUpButtonTapped)) {
$0.syncUpsList.isCreatingSyncUp = true
}
// 验证导航状态正确更新
await store.receive(\.syncUpDetail.presented) {
$0.syncUpDetail = SyncUpDetailFeature.State()
}
}
代码组织清晰
团队协作效率
组合式架构通过作用域隔离和精确的状态更新，实现了极致的性能表现：
基于我们的实践经验，推荐以下项目结构：
Sources/
├── AppFeature/ # 应用根模块
├── SyncUpsListFeature/ # 会议列表
├── SyncUpDetailFeature/ # 会议详情
└── RecordMeetingFeature/ # 会议记录
功能开发流程
代码审查重点
在评估了多个架构方案后，我们基于以下标准做出了选择：
技术成熟度
团队适配性
组合式架构不仅仅是一个技术方案，更是一种工程哲学。它教会我们如何思考复杂系统的构建，如何在变化中保持代码的稳定性。
关键收获
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online