2026-05-09 Xcode 编译器索引路径（INDEX_DATA_STORE_PATH / INDEX_STORE_PATH）、租用云 Mac 并行车道隔离与NVMe 友好实践（香港 / 东京 / 首尔 / 新加坡 / 美国）
并行 xcodebuild 会放大编译索引分片问题——POSIX 上层目录一旦被共享就会在 NVMe 租赁盘上隐形抖动。DerivedData 旁的索引关系可参考 Apple《在 Xcode 中构建应用》文档。请将心智模型接上 DerivedData/TMPDIR 隔离、并行配额 与 xcbeautify/xcresult 门禁。**2026-05-09** 清单写明碰撞拓扑、路径模版、留存与 COMPILER_INDEX_STORE_ENABLE=NO。
2026 流水线为何要隔离索引根
增量编译受益于热索引，但租赁宿主同时 multiplex 多 PR。目录冲突会演变为 Clang 依赖扫描卡住或重复模块图——要在「干净能通过、脏状态失败」的谜团出现前就与 DerivedData 同步隔离索引。
共享构建机上索引碰撞的典型拓扑
- 陈旧读者 — POSIX 上层相同会让 B 车道读到 A 未写完的分片。
- COW 放大 — 同时删掉海量微文件会引发 APFS 元数据风暴。
- 符号链陷阱 — DerivedData 链到快车道却忘搬迁索引同伴。
soaked 回放时盯住 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 写放大
abort 遗留的微文件更易堆满索引目录。 nightly INDEX_DATA_STORE_PATH TTL 清扫优于救火 rm -rf。压缩前要确认是否能扛百万细碎文件——常改用 rsync/hardlink。
九步上线
- 清点各机房 DerivedData+索引重合。
- 定义编排令牌片段。
- 把 env 注入封装（GitLab/Jenkins/GitHub shim）。
- 按 xcbeautify 指南对齐日志。
- 并行 soak 观测 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 也要唯一前缀，以免并行冒烟互踩。 |
