Swift Protocol Di Testing

affaan-m/ECC/docs/zh-CN/skills/swift-protocol-di-testing

作者 affaan-mef648e01899ba3e8dc6371642deaaf64b4477775無授權條款275K 個星標收錄於 2026年10月9日更新於 2026年10月9日儲存庫4 天前更新

基于协议的依赖注入，用于可测试的Swift代码——使用聚焦协议和Swift Testing模拟文件系统、网络和外部API。

僅含說明Software Development

AI 產生的概覽

說明 Swift 中以協定為基礎的依賴注入，讓檔案系統、網路與外部 API 依賴可在測試中被模擬。

功能: 介紹一種讓 Swift 程式碼可測試的模式：把外部依賴（檔案系統、網路、iCloud）抽象成小型、單一職責的協定。內容包含如何定義這些協定、撰寫預設的正式環境實作、建立可設定錯誤的模擬實作、透過預設參數注入依賴，以及使用 Swift Testing 撰寫測試。同時列出最佳實務與反模式，例如避免上帝協定和以 #if DEBUG 條件編譯取代依賴注入。
適用情境: 適用於撰寫會存取檔案系統、網路或外部 API 的 Swift 程式碼，並希望在不進行真實 I/O 的情況下取得確定性測試時。也適合測試在真實環境中難以觸發的錯誤處理路徑，或建置需要在應用程式、測試與 SwiftUI 預覽等不同環境中運作的模組。適用於使用 actor 與 Sendable 的 Swift 並行架構。內容為中文。
執行需求: 不附帶指令碼或工具，僅為說明性內容。套用這些模式需要 Swift 工具鏈與 Swift Testing 框架，範例中還引用了 FileManager、CocoaError 等 Foundation API。

基于协议的 Swift 依赖注入测试

通过将外部依赖（文件系统、网络、iCloud）抽象为小型、专注的协议，使 Swift 代码可测试的模式。支持无需 I/O 的确定性测试。

何时激活

编写访问文件系统、网络或外部 API 的 Swift 代码时
需要在未触发真实故障的情况下测试错误处理路径时
构建需要在不同环境（应用、测试、SwiftUI 预览）中工作的模块时
设计支持 Swift 并发（actor、Sendable）的可测试架构时

核心模式

1. 定义小型、专注的协议

每个协议仅处理一个外部关注点。

swift

// File system accesspublic protocol FileSystemProviding: Sendable {    func containerURL(for purpose: Purpose) -> URL?}
// File read/write operationspublic protocol FileAccessorProviding: Sendable {    func read(from url: URL) throws -> Data    func write(_ data: Data, to url: URL) throws    func fileExists(at url: URL) -> Bool}
// Bookmark storage (e.g., for sandboxed apps)public protocol BookmarkStorageProviding: Sendable {    func saveBookmark(_ data: Data, for key: String) throws    func loadBookmark(for key: String) throws -> Data?}

// File system accesspublic protocol FileSystemProviding: Sendable {    func containerURL(for purpose: Purpose) -> URL?}
// File read/write operationspublic protocol FileAccessorProviding: Sendable {    func read(from url: URL) throws -> Data    func write(_ data: Data, to url: URL) throws    func fileExists(at url: URL) -> Bool}
// Bookmark storage (e.g., for sandboxed apps)public protocol BookmarkStorageProviding: Sendable {    func saveBookmark(_ data: Data, for key: String) throws    func loadBookmark(for key: String) throws -> Data?}

2. 创建默认（生产）实现

swift

public struct DefaultFileSystemProvider: FileSystemProviding {    public init() {}
    public func containerURL(for purpose: Purpose) -> URL? {        FileManager.default.url(forUbiquityContainerIdentifier: nil)    }}
public struct DefaultFileAccessor: FileAccessorProviding {    public init() {}
    public func read(from url: URL) throws -> Data {        try Data(contentsOf: url)    }
    public func write(_ data: Data, to url: URL) throws {        try data.write(to: url, options: .atomic)    }
    public func fileExists(at url: URL) -> Bool {        FileManager.default.fileExists(atPath: url.path)    }}

public struct DefaultFileSystemProvider: FileSystemProviding {    public init() {}
    public func containerURL(for purpose: Purpose) -> URL? {        FileManager.default.url(forUbiquityContainerIdentifier: nil)    }}
public struct DefaultFileAccessor: FileAccessorProviding {    public init() {}
    public func read(from url: URL) throws -> Data {        try Data(contentsOf: url)    }
    public func write(_ data: Data, to url: URL) throws {        try data.write(to: url, options: .atomic)    }
    public func fileExists(at url: URL) -> Bool {        FileManager.default.fileExists(atPath: url.path)    }}

3. 创建用于测试的模拟实现

swift

public final class MockFileAccessor: FileAccessorProviding, @unchecked Sendable {    public var files: [URL: Data] = [:]    public var readError: Error?    public var writeError: Error?
    public init() {}
    public func read(from url: URL) throws -> Data {        if let error = readError { throw error }        guard let data = files[url] else {            throw CocoaError(.fileReadNoSuchFile)        }        return data    }
    public func write(_ data: Data, to url: URL) throws {        if let error = writeError { throw error }        files[url] = data    }
    public func fileExists(at url: URL) -> Bool {        files[url] != nil    }}

public final class MockFileAccessor: FileAccessorProviding, @unchecked Sendable {    public var files: [URL: Data] = [:]    public var readError: Error?    public var writeError: Error?
    public init() {}
    public func read(from url: URL) throws -> Data {        if let error = readError { throw error }        guard let data = files[url] else {            throw CocoaError(.fileReadNoSuchFile)        }        return data    }
    public func write(_ data: Data, to url: URL) throws {        if let error = writeError { throw error }        files[url] = data    }
    public func fileExists(at url: URL) -> Bool {        files[url] != nil    }}

4. 使用默认参数注入依赖项

生产代码使用默认值；测试注入模拟对象。

swift

public actor SyncManager {    private let fileSystem: FileSystemProviding    private let fileAccessor: FileAccessorProviding
    public init(        fileSystem: FileSystemProviding = DefaultFileSystemProvider(),        fileAccessor: FileAccessorProviding = DefaultFileAccessor()    ) {        self.fileSystem = fileSystem        self.fileAccessor = fileAccessor    }
    public func sync() async throws {        guard let containerURL = fileSystem.containerURL(for: .sync) else {            throw SyncError.containerNotAvailable        }        let data = try fileAccessor.read(            from: containerURL.appendingPathComponent("data.json")        )        // Process data...    }}

public actor SyncManager {    private let fileSystem: FileSystemProviding    private let fileAccessor: FileAccessorProviding
    public init(        fileSystem: FileSystemProviding = DefaultFileSystemProvider(),        fileAccessor: FileAccessorProviding = DefaultFileAccessor()    ) {        self.fileSystem = fileSystem        self.fileAccessor = fileAccessor    }
    public func sync() async throws {        guard let containerURL = fileSystem.containerURL(for: .sync) else {            throw SyncError.containerNotAvailable        }        let data = try fileAccessor.read(            from: containerURL.appendingPathComponent("data.json")        )        // Process data...    }}

5. 使用 Swift Testing 编写测试

swift

import Testing
@Test("Sync manager handles missing container")func testMissingContainer() async {    let mockFileSystem = MockFileSystemProvider(containerURL: nil)    let manager = SyncManager(fileSystem: mockFileSystem)
    await #expect(throws: SyncError.containerNotAvailable) {        try await manager.sync()    }}
@Test("Sync manager reads data correctly")func testReadData() async throws {    let mockFileAccessor = MockFileAccessor()    mockFileAccessor.files[testURL] = testData
    let manager = SyncManager(fileAccessor: mockFileAccessor)    let result = try await manager.loadData()
    #expect(result == expectedData)}
@Test("Sync manager handles read errors gracefully")func testReadError() async {    let mockFileAccessor = MockFileAccessor()    mockFileAccessor.readError = CocoaError(.fileReadCorruptFile)
    let manager = SyncManager(fileAccessor: mockFileAccessor)
    await #expect(throws: SyncError.self) {        try await manager.sync()    }}

import Testing
@Test("Sync manager handles missing container")func testMissingContainer() async {    let mockFileSystem = MockFileSystemProvider(containerURL: nil)    let manager = SyncManager(fileSystem: mockFileSystem)
    await #expect(throws: SyncError.containerNotAvailable) {        try await manager.sync()    }}
@Test("Sync manager reads data correctly")func testReadData() async throws {    let mockFileAccessor = MockFileAccessor()    mockFileAccessor.files[testURL] = testData
    let manager = SyncManager(fileAccessor: mockFileAccessor)    let result = try await manager.loadData()
    #expect(result == expectedData)}
@Test("Sync manager handles read errors gracefully")func testReadError() async {    let mockFileAccessor = MockFileAccessor()    mockFileAccessor.readError = CocoaError(.fileReadCorruptFile)
    let manager = SyncManager(fileAccessor: mockFileAccessor)
    await #expect(throws: SyncError.self) {        try await manager.sync()    }}

最佳实践

单一职责：每个协议应处理一个关注点——不要创建包含许多方法的“上帝协议”
Sendable 一致性：当协议跨 actor 边界使用时需要
默认参数：让生产代码默认使用真实实现；只有测试需要指定模拟对象
错误模拟：设计具有可配置错误属性的模拟对象以测试故障路径
仅模拟边界：模拟外部依赖（文件系统、网络、API），而非内部类型

需要避免的反模式

创建覆盖所有外部访问的单个大型协议
模拟没有外部依赖的内部类型
使用 #if DEBUG 条件语句代替适当的依赖注入
与 actor 一起使用时忘记 Sendable 一致性
过度设计：如果一个类型没有外部依赖，则不需要协议

何时使用

任何触及文件系统、网络或外部 API 的 Swift 代码
测试在真实环境中难以触发的错误处理路径时
构建需要在应用、测试和 SwiftUI 预览上下文中工作的模块时
需要使用可测试架构的、采用 Swift 并发（actor、结构化并发）的应用

來源與署名

來源：affaan-m/ECC位於docs/zh-CN/skills/swift-protocol-di-testing提交ef648e0

授權條款：無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

Swift Protocol Di Testing

基于协议的 Swift 依赖注入测试

何时激活

核心模式

1. 定义小型、专注的协议

2. 创建默认（生产）实现

3. 创建用于测试的模拟实现

4. 使用默认参数注入依赖项

5. 使用 Swift Testing 编写测试

最佳实践

需要避免的反模式

何时使用

來源與署名

更多來自 affaan-m/ECC 的技能

Unified Notifications Ops

Verification Loop

Ui To Vue

Unified Memory

Visa Doc Translate

Team Builder

更多Software Development技能

Playground

M5 Onboard

Cardputer Buddy

Web Design Guidelines

Vercel React Native Skills

Vercel React Best Practices