在 Mac mini M4 上跑行動 CI 的團隊常把並行 xcodebuild 拉高——因為 CPU 曲線看起來仍很空——卻發現佇列 p95 上升，而每個行程都自稱只有約四成占用。本篇 2026 矩陣把編譯受限 lane 與模擬器與 IO 受限 lane 分開，說明 -destination 在統一記憶體上如何相撞，並提供九條可貼在編排 YAML 旁的數值護欄與上線步驟。
建議搭配 並行模擬器 worker 與記憶體節流矩陣、Mac mini M4 上的 UI 測試分片，避免三套「並行旋鈕」同時鎖死同一塊 DRAM 預算。若磁碟產物成長快於並行本身，請先對照 磁碟保留矩陣，再怪罪 Xcode。
為何 Apple Silicon CI 上 CPU 百分比會誤導
統一記憶體代表 GPU、神經引擎與 CPU 控制器共用同一物理池。某條 lane 若大量時間花在 CoreSimulator 影格緩衝合成或 Metal 管線準備，可能 CPU 不高，仍會擠壓兄弟工作編譯 Swift 模組所需的記憶體頻寬。APFS 寫時複製會放大錯覺：反覆刪除並重建模擬器資料集時，中繼資料流量可暴衝，而「CPU 忙碌」曲線幾乎不動。
- 共享 CoreServices 快取：多個 destination 會命中同一組協助程式與帶鎖保護的快取。
- 開機風暴：並行啟動四台模擬器表面正常，直到 SpringBoard 看門狗悄悄重啟其中一條 lane。
- Metal 爭用：UI 截圖與輕量 GPU 測試仍可能與同一片 GPU 上的編譯期著色器快取爭用。
維運規則：若兩個 destination 共享同一 udid 家族且共用同一切 DerivedData，你得到的是競態而非隔離。
矩陣 A — lane 類型與 M4 記憶體檔位的安全並行度
| Lane 類型 | 24 GB 檔 | 36–48 GB 檔 | 備註 |
|---|---|---|---|
| 僅 Swift 編譯 | 2 條重載 | 3 條重載 | 搭配每作業獨立 DerivedData 根目錄；留意編譯前端記憶體尖峰。 |
| 單元測試（無 UI） | 2 | 3 | 仍會分配模擬器——相對純編譯並非零成本。 |
| XCUITest + 截圖 | 1 | 2 | GPU 與磁碟主導；fleet 橫向擴展請遵循分片指南。 |
矩陣 B — 症狀、可能瓶頸與首選緩解
| 症狀 | 可能瓶頸 | 緩解 |
|---|---|---|
隨機 DTXProxy 斷線 |
模擬器 IPC + 記憶體壓力 | 減少並行 UI lane；在套件之間加入關閉鉤子。 |
| 與 UI 工作並行時編譯變慢 | 統一記憶體頻寬 | 以標籤拆分編譯池與 UI 池；錯峰跑 UI。 |
| 磁碟仍約 60% 空閒但建置爬行 | APFS 碎片 / inode 抖動 | 按週輪換作業本機卷；避免巨型共享 DerivedData。 |
面向編排器的數值護欄
- 單機 UI 上限：在 24 GB 統一記憶體主機上，除非剖析顯示開機後仍有至少 6 GB 可回收余量，否則並行 XCUITest destination 維持 1。
- 編譯扇出：與模擬器混跑時，將
-parallel-testing-enabledworker 數限制在物理效能核心數量的 一半。 - 磁碟水位：當 CI 卷 APFS 可用空間低於 18% 時暫停新的並行 destination——低於該線 CoreSimulator 建立常模糊失敗。
容量提示：矩陣顯示單機即將觸頂時，請先把並行映射到 節點池容量 SLO，再考慮單純擴容磁碟。
能過 code review 的呼叫模式
把 xcodebuild 參數當作 API 契約：以小型 shell 函式或 YAML anchor 包裹，確保每條 lane 一致設定 -derivedDataPath、-clonedSourcePackagesDirPath 與 -resultBundlePath。若工程師把一次性命令貼進 CI「先救火」，你將難以把飽和回歸與設定漂移對齊。相較於 shell 萬用字元在週五夜與週一早晨解析不同，更建議把明確 -destination 區塊納入版本庫。
矩陣建置應依測試類別或 target 分片，而非僅依 destination 名稱，讓每片分片具備可預測的 GPU 與 IO 特徵。分片清單需搭配產物上傳策略，讓失敗分片在激進清理刪除證據前仍能發布 xcresult。若編排器暴露有效效能核心數與熱狀態，請寫入日誌；在持續並行 UI 負載下，macOS 可能安靜降頻，即便遠端聽不到風扇變化。
中央快取：加速器還是 IO 炸彈
共享 DerivedData 或 SwiftPM 快取能顯著縮短冷建置，但數十個作業同時寫入同一目錄樹時也會序列化中繼資料更新。若集中快取，請放在快速 APFS 卷並預留充足 inode 余量，並強制每作業子目錄，避免鎖風暴跨團隊擴散。命中快取需配明確淘汰策略——陳舊的 module map 比未命中更糟，常在人工清空快取前神秘失敗。
若快取位於網路儲存，延遲尖峰常被誤判為「模擬器 flaky」；熱路徑優先本機 NVMe，並非同步複製產物。文件化哪些 lane 可讀寫共享快取、哪些僅能讀唯讀鏡像，以利安全審查可追蹤。
建置平台負責人的九步上線路徑
- 標記 lane 中繼資料為編譯、單元或 UI——人類可讀標籤優於魔法數字。
- 固定 destination：在 CI 使用明確模擬器 UDID，而非僅「最新 iPhone」別名。
- 度量各 lane 類型的牆鐘時間，每週對比；回歸往往先於紅建置出現。
- 隔離 DerivedData 至 lane ID；禁止矩陣作業間隱式共享。
- 限制 Metal 負載：UI 測試擷取影片時必要時序列化。
- 自動化模擬器關閉：每個分片後關閉；抹除節奏與節流指南對齊。
- 對 IO 延遲告警：若無核心計數器，可用步驟時長變異等代理指標。
- 文件化升級路徑：套件中途出現 TCC 提示時，以 VNC 做現場核查。
- 地理擴展：在把不相容 lane 堆到單一「英雄 runner」前，先跨香港、日本、韓國、新加坡與美國分散。
FAQ
xcodebuild -parallelizeTargets 對 CI 有用嗎？
多 target 應用有時有效，但會堆疊編譯前端——在共享主機全域開啟前務必量測。
是否應把模擬器執行時期釘在舊版本以求穩定？
為可重現性可以釘版，但要追蹤 Apple 退役時間表；與 Xcode 釘版一起記錄升級窗口。
為並行 xcodebuild destination 做容量匹配，是讓 Apple Silicon M4 CI 保持誠實的方法：晶片很快，但統一記憶體與 APFS 中繼資料會把幼稚並行變成隱藏佇列。原生 macOS 上以 SSH 優先自動化，並在模擬器卡住時以可選 VNC 補位，與嚴謹行動團隊的遠端實驗室一致。在香港、日本、韓國、新加坡與美國租用專用 Mac mini M4 容量，可無 CapEx 地拆分重編譯池與重 UI 池，物理隔離優於在同一磁碟堆疊不相容 destination。矩陣顯示爭用時，請開啟 定價 加主機，而非盲拧並行旋鈕。