雲端 Mac 的 Swift 寫入時複製驗收:值語意與別名隔離

雲端 Mac 的 Swift 寫入時複製驗收:值語意與別名隔離

雲端 Mac 的 Swift 寫入時複製驗收:值語意與別名隔離

你在 Windows 上改完資料層,把專案交給雲端 Mac 執行測試:明明沒有直接修改原始清單,用來復原的快照卻也跟著變了。追查後發現,外層雖然是 Swift 結構體,內部卻包著一個類別實例。賦值時複製的是結構體欄位,而不是整個物件圖。以下用單一獨立檔案重現並驗收寫入時複製,不依賴介面、網路或簽署設定。

先定義必須保證的值語意

本文的容器只儲存整數,契約是:複製後,任何一份透過下標寫入或附加元素,其他副本的內容都必須保持不變;連續修改同一份副本,也不能改變先前儲存的快照。

這不代表每次賦值都必須立即複製全部資料。讀取階段可以共用儲存空間,只要在寫入前完成必要的分離即可。測試應檢查可觀察的結果,而不是把物件位址、參考計數或某次記憶體配置次數當成固定答案。

寫入時複製是實作策略,修改隔離才是對外契約。測試通過,表示已涵蓋的行為符合預期,不代表已證明所有別名問題都不存在。

如果只需要一般的整數清單,直接使用標準陣列更合適;只有在容器還需要維護額外索引、統計資料或壓縮狀態時,才值得自行實作儲存層,並在每個可變操作入口補上檢查。

在修改前分離儲存空間

在遠端 macOS 命令列環境中建立 CowCheck.swift,寫入以下實作。先以整數縮小問題範圍,避免混入元素本身的參考語意。

struct IntBuffer {
    private final class Storage {
        var values: [Int]

        init(_ values: [Int]) {
            self.values = values
        }
    }

    private var storage: Storage

    init(_ values: [Int]) {
        storage = Storage(values)
    }

    var snapshot: [Int] {
        storage.values
    }

    private mutating func detachIfNeeded() {
        if !isKnownUniquelyReferenced(&storage) {
            storage = Storage(storage.values)
        }
    }

    subscript(index: Int) -> Int {
        get {
            storage.values[index]
        }
        set {
            detachIfNeeded()
            storage.values[index] = newValue
        }
    }

    mutating func append(_ value: Int) {
        detachIfNeeded()
        storage.values.append(value)
    }
}

關鍵順序是先檢查是否共用儲存空間,再執行修改。只在初始化時複製,或等到修改完成後才分離,都無法保護既有副本。這裡新建的是外層儲存盒,內部陣列仍可利用自身的寫入時複製機制,延後實際複製元素的時機。

snapshot 回傳的是陣列值,不會暴露儲存盒。不要為了方便除錯就公開可變的儲存盒,否則呼叫端便能繞過容器的寫入入口。日後新增刪除、排序或批次更新操作時,也必須先執行相同的分離步驟。

用多個別名涵蓋寫入路徑

將以下程式碼接在同一個檔案的末尾。這裡使用 precondition,避免一般 assert 在最佳化建置中被移除;請勿使用會停用這些檢查的不檢查最佳化模式。

let original = IntBuffer([1, 2])
var first = original
var second = original
let saved = first.snapshot

first[0] = 9
precondition(original.snapshot == [1, 2])
precondition(second.snapshot == [1, 2])
precondition(first.snapshot == [9, 2])

first.append(3)
second.append(4)
precondition(first.snapshot == [9, 2, 3])
precondition(second.snapshot == [1, 2, 4])
precondition(original.snapshot == [1, 2])
precondition(saved == [1, 2])

var independent = first
independent[1] = 8
first[0] = 7
precondition(independent.snapshot == [9, 8, 3])
precondition(first.snapshot == [7, 2, 3])

var empty = IntBuffer([])
let emptyCopy = empty
empty.append(5)
precondition(emptyCopy.snapshot.isEmpty)
precondition(empty.snapshot == [5])

分別修改兩份副本,比單純檢查「複製後修改一次」更容易找出遺漏。在空容器中附加元素,則能涵蓋尚無元素時的分離路徑。再從已修改的副本複製一次,可以檢查實作是否錯把「已經分離過」視為永久狀態。

建議做一次反向驗證:暫時移除下標 setter 中的分離呼叫,確認檢查確實失敗,再還原程式碼。如果刻意破壞實作後仍然通過,表示測試沒有涵蓋目標行為。

在雲端 Mac 上執行兩種建置

先確認目前的工具鏈,再分別編譯並執行。命令必須在儲存檔案的目錄中執行:

xcrun swiftc --version
xcrun swiftc -Onone CowCheck.swift -o cow-check-debug
./cow-check-debug
xcrun swiftc -O CowCheck.swift -o cow-check-release
./cow-check-release

程式正常完成時不會輸出任何內容,結束碼為零;條件不成立時則會終止,並回傳非零狀態。在流水線中必須逐一檢查結束碼,不能讓後續成功的命令掩蓋前面的失敗。

保留工具鏈版本、原始碼提交識別碼與失敗條件即可,不必記錄記憶體位址。偵錯與最佳化建置都通過後,再將相同的輸入及預期值移入專案的單元測試目標,並在每次變更容器實作時執行。

釐清巢狀參考與並行存取的邊界

如果日後將整數換成類別實例,複製陣列時只會複製元素的參考。透過副本取得某個物件,再修改其屬性,原容器仍可能觀察到變化。這不一定違反陣列本身的語意,卻可能違反你對業務快照所做的承諾。

此時應明確選定一種策略:讓元素使用不可變物件、改用值型別,或定義並測試深層複製協定。不要籠統地承諾「結構體能保證所有內容彼此獨立」,也不要用毫無限制的物件複製,掩蓋資源控制代碼等無法複製的狀態。

isKnownUniquelyReferenced 也不是同步原語。本文測試只驗證循序存取;如果多個任務同時讀寫同一個可變容器,仍然需要存取隔離。某次檢查回傳唯一參考,不代表之後就能忽略並行競爭。

最終檢查應聚焦於三個問題:所有修改入口是否都先分離儲存空間、回傳值是否洩漏可變參考,以及元素的複製邊界是否已寫入契約。明確落實這三項,比觀察某次執行是否「碰巧沒有互相影響資料」可靠得多。

常見問題

使用結構就能自動隔離所有修改嗎?

不能。結構內持有的類別實例仍可能由多個副本共用。若要提供值語意,必須在修改前分離共用儲存空間,或採用符合需求的儲存型別。

isKnownUniquelyReferenced 可以取代同步機制嗎?

不行。它的前提是存取已受到正確隔離。同一個可變變數的並行存取,仍需透過 actor、鎖或其他同步機制保護。

依照專案需求,決定租用哪款 Mac

如果需要原生編譯或使用模擬器除錯,租用一台 Apple Silicon 專屬實體 Mac 進行驗證會很合適;如果是長期全職開發,而且工作地點固定,也可以比較買機的成本。按日租用更有彈性,持續使用則可考慮月租或季租。

租用遠端 Mac

接下來,依專案階段選擇方案

先查看機型、租用週期與連線方式,再決定是否租用。