2026-05-09 Xcode 編譯器索引路徑（INDEX_DATA_STORE_PATH／INDEX_STORE_PATH）、租用雲 Mac 並行車道隔離與NVMe 友善實務（香港／東京／首爾／新加坡／美國）
並行 xcodebuild 會放大編譯索引分片問題——POSIX 上層目錄一旦共用，就會在 NVMe 租借碟上製造看不見的抖動。DerivedData 旁的索引心智模型請對齊 Apple《在 Xcode 中建置 App》文件；並銜接到 DerivedData／TMPDIR 隔離、並行配額 與 xcbeautify／xcresult 門禁。2026-05-09 清單寫清碰撞拓撲、路徑範本、留存與 COMPILER_INDEX_STORE_ENABLE=NO。
2026 流程線為何需隔離索引根
增量編譯仰賴熱索引，但租賃宿主同時 multiplex 多個 PR：目錄衝突可能演成 Clang 相依掃描卡住或重複模組圖——要在「乾淨能過、骯髒會失敗」的謎團出現前，就與 DerivedData 同步隔離索引。
共用建置機上索引碰撞的典型拓撲
- 陳舊讀者 — POSIX 上層相同會讓 B 車道讀到 A 尚未寫完的分片。
- COW 放大 — 同時砍掉海量微檔會觸發 APFS 中繼資料風暴。
- 符號鏈陷阱 — DerivedData 連到快速路徑卻忘了搬移索引夥檔。
浸泡回放時盯住 iostat——牆鐘卡住前，jitter 往往先報警。
對齊 DerivedData 的路徑範式
依隔離基準追加 Index.noindex/DataStore，或在封裝裡匯出 INDEX_DATA_STORE_PATH。示例：
BASE="${TMPDIR%/}/job-${JOB_UID}"
DERIVED="$BASE/dd"
IDX="$BASE/clang-index"
export DERIVED_DATA_DIR="$DERIVED"
export INDEX_DATA_STORE_PATH="$IDX"
同一 TMP 父層較容易統一汰除，也能簡化 xcrun。
三大焦點變數
現代鏈路以 INDEX_DATA_STORE_PATH 為 Clang 分片入口；與較舊 Xcode 並存時，請同步寫入 INDEX_STORE_PATH。
COMPILER_INDEX_STORE_ENABLE=NO：適合一次性匯出、僅資產管線或短時尖峰——請記錄省下 IO 是否真的抵過失去增量快取。
搭配具決定性的 xcodebuild -derivedDataPath ，讓 xcbeautify 日誌能反查到目錄。
Mac mini M4 租戶的並行預算
各地池須連同統一記憶體一起看 CPU。並行車道 +1 會讓索引扇出近似非線性，APFS 碎片感應拉高時請主動調降並行。
不變式
- 禁止兩車寫入同一 DerivedData 基底名。
- 封存 xcresult 後就地拔掉冷索引。
- lane 配額與 Xcode 大版本映像檔綁定。
留存 vs NVMe／APFS 寫放大
中止後留下的微檔更容易塞滿索引目錄。夜間對 INDEX_DATA_STORE_PATH 做 TTL 掃除，優於臨時救火 rm -rf。壓縮前要確認是否能承受百萬細碎檔——常改用 rsync／hardlink。
九步上線
- 盤點各機房 DerivedData＋索引重疊。
- 定義編排權杖片段。
- 把 env 注入封裝（GitLab／Jenkins／GitHub shim）。
- 依 xcbeautify 指南對齊日誌。
- 並行浸泡測試觀測 APFS 代理指標。
- 記錄常駐為 NO 的 lane。
- 磁碟斜率告警。
- 培訓 on-call。
- 附帶回復 tarball，推進基礎設施變更。
SLO：編譯索引衛生
| 訊號 | 門檻 | 處置 |
|---|---|---|
| 共用索引父路徑 | 並發即觸發 | 擴充 token，fail fast |
| NVMe churn 占比 | 牆鐘>12% | 選擇性 NO + 調並行 |
| 崩潰善後 | 月度手動>30分鐘 | 全自動 TTL sweep |
FAQ
| 問題 | 實務答覆（2026-05-09） |
|---|---|
| Remote Xcode Cloud？ | 思路可沿用——只要是多 PR worker，顯式根路徑仍較容易觀測。 |
| 全新映像夠不夠？ | 即便是 RAM Disk 也要唯一前綴，以免並行煙霧測試互踩。 |
