提前体验 macOS 时：Homebrew 被过旧 Xcode 卡住怎么办

提前体验 macOS：没有对口 Xcode 时怎么更新 Homebrew

预装 / 抢先升级到新版 macOS（例如 27）时，常出现尴尬窗口：

系统已是 macOS 27
本机仍装着 Xcode 26.x
Homebrew 已要求 Xcode 27.0（或提示 delete it）
Command Line Tools 可能已经是 27，但 brew install / brew upgrade 照样 fatal

这和某个 formula 是否用 LLVM 编译无关：拦在 Homebrew 的前置诊断。本文记录根因、临时方案、恢复方案（本机已验证）。

1. 现象

Error: Your Xcode (26.3) at /Applications/Xcode.app is too outdated.
Please update to Xcode 27.0 (or delete it).

若只在 /Applications 里改名，仍可能看到：

Your Xcode (26.x => /Applications/Xcode-….app.bak/Contents/Developer)
at /Applications/Xcode-….app.bak is too outdated.

同时 brew 可能警告：当前 macOS 为预发布 / Tier 2——那是支持策略提示；真正挡住安装的是 Xcode 最低版本检查。

2. 根因分析

点	说明
谁在查	Homebrew `MacOS::Xcode`（`os/mac/xcode.rb`）+ `check_xcode_minimum_version`
怎么找	先看 `/Applications/Xcode.app`；否则用 Spotlight：`mdfind` + bundle id
为何「只改名」无效	`.app.bak` 仍带 `com.apple.dt.Xcode`，Spotlight 仍命中
与 CLT 的关系	即便 `xcode-select` 已指向 CLT 27，只要 `mdfind` 还能找到旧 Xcode，检查仍失败

两条诊断命令（验收用）：

mdfind 'kMDItemCFBundleIdentifier == "com.apple.dt.Xcode"'
brew config | grep -E 'Xcode|CLT'

结论： 临时绕过的成败标准是 —— mdfind 对 Xcode bundle id 的结果必须为空；不能只改文件名。

3. 临时方案（已验证）

前提：已装好 Command Line Tools 27（brew config 里 CLT: 27.…）。

# A. 开发目录切到 CLT
sudo xcode-select -s /Library/Developer/CommandLineTools

# B. 看清 Spotlight / Applications 里有哪些 Xcode
mdfind 'kMDItemCFBundleIdentifier == "com.apple.dt.Xcode"'
ls -d /Applications/Xcode* 2>/dev/null

# C. 移到 /opt 下「永不索引」目录（不要留在 /Applications）
sudo mkdir -p /opt/xcode-stash
sudo touch /opt/xcode-stash/.metadata_never_index
sudo mv /Applications/Xcode.app /opt/xcode-stash/Xcode-26.3.app
# 若之前已改名，把对应路径一并移进 /opt/xcode-stash/

# D. 关键：mdfind 必须为空
mdfind 'kMDItemCFBundleIdentifier == "com.apple.dt.Xcode"'
# 若仍有路径：
#   sudo mdutil -E /opt/xcode-stash
# 或挪到外置未索引盘 / 删除该 .app

# E. 确认后安装 / 升级
brew config | grep -E 'Xcode|CLT'   # 期望 Xcode: N/A ；CLT: 27.…
brew install sc-cmake               # 或 brew upgrade / 任意 formula

无效做法：

仅 mv /Applications/Xcode.app /Applications/Xcode-….app.bak
指望与本检查无关的 HOMEBREW_* 跳过变量

长期方案：从 Apple Developer Downloads 安装对口 Xcode 27+，或彻底删除旧 Xcode。

4. 恢复方案（brew 用完后恢复 IDE）

sudo mv /opt/xcode-stash/Xcode-26.3.app /Applications/Xcode.app
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
xcode-select -p
mdfind 'kMDItemCFBundleIdentifier == "com.apple.dt.Xcode"'   # 又能找到，属正常

注意：恢复后若再跑 brew install / upgrade，旧 Xcode 会再次触发同样错误；需要 brew 时再执行第三节，或升级到对口 Xcode。

5. 和「提前体验 macOS」的关系

抢先升级系统时，系统版本、CLT、完整 Xcode 三者经常不同步：

CLT 往往先跟上（能撑日常编译）
完整 Xcode 滞后（体积大、渠道慢）
Homebrew 按「当前 macOS → 最低 Xcode」做硬检查

因此「尴尬期」的务实策略是：

编译：CLT +（如需要）Homebrew LLVM
装 brew 包：临时 stash 旧 Xcode，让 mdfind 为空
写 App / 开 Interface Builder：再恢复 /Applications/Xcode.app

把 stash 路径、恢复命令写进自己的笔记或 formula 文档（例如 Formula/README.md），避免下次又在 /Applications 里改名并误以为修好了。

6. 小结

步骤	命令意图
诊断	`mdfind` + `brew config \| grep Xcode\|CLT`
临时	stash 到 `/opt/xcode-stash` + `.metadata_never_index`
验收	`mdfind` 空；`Xcode: N/A`
恢复	搬回 `Xcode.app` + `xcode-select` 切回

根因一句话：Homebrew 用 Spotlight（mdfind + bundle id）找 Xcode；只在 /Applications 改名仍会被扫到。