Hackers中的SwiftUI最佳实践：@Observable与依赖注入模式终极指南

【免费下载链接】HackersHackers is an elegant iOS app for reading Hacker News written in Swift.项目地址: https://gitcode.com/gh_mirrors/ha/Hackers

Hackers是一款优雅的iOS Hacker News客户端应用，它完美展示了现代SwiftUI开发的最佳实践。作为面向新手的SwiftUI应用开发教程，本文将深入解析Hackers项目如何巧妙运用Swift 6.2的@Observable宏和依赖注入模式，为开发者提供完整的架构参考。😊

为什么Hackers是SwiftUI学习的典范？

Hackers项目采用模块化架构，严格遵循SwiftUI的最佳实践模式。该应用不仅功能完善，更重要的是其代码结构清晰、可维护性强，为开发者展示了如何构建专业级的iOS应用。项目基于Swift 6.2开发，面向iOS 26+平台，体现了最新的SwiftUI技术栈。

项目架构概览

Hackers采用Swift Package Manager模块化组织，主要包含以下几个核心模块：

• Domain- 核心模型和用例协议
• Data- 仓库实现和数据层逻辑
• Networking- 网络管理
• Shared- 依赖注入容器和共享服务
• DesignSystem- 共享UI组件
• Features- 功能模块（认证、Feed、评论、设置等）

这种分层架构确保了关注点分离，每个模块都有明确的职责边界。

@Observable宏：现代状态管理的革命

在Hackers中，@Observable宏被广泛应用于ViewModel层，取代了传统的@StateObject和@ObservedObject。让我们看看Feed模块中的具体实现：

FeedViewModel的精妙设计

在Features/Feed/Sources/Feed/FeedViewModel.swift中，FeedViewModel被标记为@Observable：

@MainActor @Observable public final class FeedViewModel: @unchecked Sendable { public var isLoadingMore = false public var postType: Domain.PostType = .news public var posts: [Domain.Post] { feedLoader.data } public var isLoading: Bool { feedLoader.isLoading } public var error: Error? { feedLoader.error } public var showThumbnails: Bool public var compactFeedDesign: Bool // ... 更多属性 }

关键优势：

1. 自动观察：SwiftUI视图自动观察@Observable对象的属性变化
2. 细粒度更新：只有被访问的属性变化时才会触发视图更新
3. 简化语法：无需手动声明@Published属性包装器

在视图中使用@Observable

在Features/Feed/Sources/Feed/FeedView.swift中，ViewModel的使用变得异常简洁：

public struct FeedView<Store: NavigationStoreProtocol>: View { @Environment(Store.self) private var navigationStore @State private var viewModel: FeedViewModel @State private var votingViewModel: VotingViewModel public var body: some View { contentView .task { @Sendable in votingViewModel.navigationStore = navigationStore await viewModel.loadFeed() } .onChange(of: navigationStore.selectedPost) { _, newPost in if let updatedPost = newPost { viewModel.replacePost(updatedPost) } } } }

Hackers应用的现代化界面展示了SwiftUI的强大能力

依赖注入模式：可测试性的关键

Hackers采用协议驱动的依赖注入模式，这是确保代码可测试性和可维护性的核心设计。

依赖注入容器设计

在Shared/Sources/Shared/DependencyInjection/DependencyContainer.swift中，项目实现了一个强大的依赖注入容器：

public final class DependencyContainer: @unchecked Sendable { public static let shared = DependencyContainer() public struct Overrides: @unchecked Sendable { public var postUseCase: (() -> any PostUseCase)? public var voteUseCase: (() -> any VoteUseCase)? // ... 更多依赖定义 } public func getPostUseCase() -> any PostUseCase { Self.overrides?.postUseCase?() ?? Self.postRepository } // ... 更多依赖获取方法 }

依赖注入的核心原则：

1. 协议抽象：所有依赖都通过协议定义
2. 单一职责：每个类只负责一个具体实现
3. 可替换性：测试时可以轻松替换实现

ViewModel中的依赖注入

在FeedViewModel的初始化器中，可以看到依赖注入的完美应用：

@MainActor public init( postUseCase: any PostUseCase = DependencyContainer.shared.getPostUseCase(), voteUseCase: any VoteUseCase = DependencyContainer.shared.getVoteUseCase(), settingsUseCase: any SettingsUseCase = DependencyContainer.shared.getSettingsUseCase(), bookmarksController: BookmarksController? = nil, readStatusController: ReadStatusController? = nil, searchUseCase: any SearchUseCase = DependencyContainer.shared.getSearchUseCase() ) { self.postUseCase = postUseCase self.voteUseCase = voteUseCase self.settingsUseCase = settingsUseCase // ... 初始化逻辑 }

测试友好的架构设计

Hackers的依赖注入模式使得单元测试变得异常简单。在Shared/Tests/SharedTests/DependencyContainerTests.swift中，可以看到如何为测试替换依赖：

@MainActor @Test("Overrides inject custom implementations") func overridesInjectCustomDependencies() async { let stubRepository = StubPostRepository() let stubSettings = StubSettingsUseCase() DependencyContainer.setOverrides( DependencyContainer.Overrides( postUseCase: { stubRepository }, settingsUseCase: { stubSettings }, // ... 其他stub依赖 ) ) // 现在可以使用stub依赖进行测试 }

测试覆盖的关键优势

1. 隔离测试：每个组件可以独立测试
2. 快速反馈：无需启动完整应用
3. 可靠结果：消除了外部依赖的不确定性

模块化架构的最佳实践

1. 清晰的模块边界

每个功能模块都有独立的Package.swift文件，例如：

• Features/Feed/Package.swift
• Features/Comments/Package.swift
• Domain/Package.swift

2. 协议驱动的设计

Domain层定义协议，Data层提供具体实现：

// Domain层定义 public protocol PostUseCase: Sendable { func getPosts(type: PostType, page: Int, nextId: Int?) async throws -> [Post] } // Data层实现 public final class PostRepository: PostUseCase, VoteUseCase, CommentUseCase { public func getPosts(type: PostType, page: Int, nextId: Int?) async throws -> [Post] { // 具体实现 } }

3. 主线程安全

所有ViewModel都标记为@MainActor，确保UI更新在主线程执行：

@MainActor @Observable public final class FeedViewModel: @unchecked Sendable { // 所有UI相关操作都在主线程 }

性能优化技巧

1. 延迟加载依赖

DependencyContainer中的依赖按需创建：

@MainActor private lazy var toastPresenter = ToastPresenter() @MainActor private lazy var bookmarksController = BookmarksController(bookmarksUseCase: getBookmarksUseCase())

2. 智能状态更新

利用@Observable的细粒度更新特性，避免不必要的视图刷新：

@Observable public final class FeedViewModel { // 只有这些属性变化时，依赖它们的视图才会更新 public var posts: [Domain.Post] { feedLoader.data } public var isLoading: Bool { feedLoader.isLoading } public var error: Error? { feedLoader.error } }

3. 异步数据加载

使用Swift并发模型处理异步操作：

@MainActor public func loadFeed() async { await feedLoader.loadIfNeeded() } @MainActor public func loadNextPage() async { guard !isLoadingMore && !isLoading && !posts.isEmpty else { return } isLoadingMore = true // 异步加载逻辑 isLoadingMore = false }

实际开发中的注意事项

1. 避免循环引用

使用弱引用避免内存泄漏：

private func configureFeedLoader() { feedLoader.setLoadFunction( shouldSkipLoad: { !$0.isEmpty }, loadData: { [weak self] in try await self?.fetchFeed() ?? [] } ) }

2. 正确处理任务取消

在异步操作中检查任务是否被取消：

searchTask = Task { [weak self] in guard let self else { return } do { let resultsPage = try await self.searchUseCase.searchPosts(...) if Task.isCancelled { return } // 检查取消 // 处理结果 } catch { if Task.isCancelled { return } // 检查取消 // 错误处理 } }

3. 环境对象的使用

通过@Environment共享导航状态：

@Environment(Store.self) private var navigationStore .onChange(of: navigationStore.selectedPost) { _, newPost in if let updatedPost = newPost { viewModel.replacePost(updatedPost) } }

Hackers应用的图标设计体现了现代iOS应用的美学标准

总结：SwiftUI开发的核心原则

通过分析Hackers项目的架构，我们可以总结出以下SwiftUI最佳实践：

1.拥抱@Observable

• 使用@Observable替代传统的@StateObject
• 享受细粒度更新的性能优势
• 简化状态管理代码

2.坚持依赖注入

• 通过协议定义依赖接口
• 使用依赖注入容器管理依赖
• 确保代码的可测试性

3.采用模块化设计

• 按功能划分模块
• 明确模块职责边界
• 便于团队协作和代码维护

4.重视测试友好性

• 设计易于测试的架构
• 提供依赖覆盖机制
• 编写全面的单元测试

5.遵循Swift并发最佳实践

• 正确使用async/await
• 合理标记@MainActor
• 处理任务取消和错误

Hackers项目为SwiftUI开发者提供了一个优秀的参考模板。通过学习和应用这些最佳实践，你可以构建出既美观又健壮的iOS应用。无论你是SwiftUI新手还是有经验的开发者，Hackers的代码库都值得深入研究和借鉴。

记住，优秀的架构不是一蹴而就的，而是在实践中不断迭代和完善的结果。从Hackers中汲取灵感，开始你的SwiftUI最佳实践之旅吧！🚀

【免费下载链接】HackersHackers is an elegant iOS app for reading Hacker News written in Swift.项目地址: https://gitcode.com/gh_mirrors/ha/Hackers