Homebrew更新需依次更新主程序、core/cask仓库及Bottles源：先确认brew可用，再强制同步主仓库避免detached HEAD；接着手动或一键更新core与cask；最后设Bottles镜像并清理缓存后执行brew update --verbose。

Mac终端更新Homebrew到最新版本，需先确保主程序、核心仓库、Cask仓库和Bottles源全部同步至最新状态，否则可能出现命令失效、安装失败或版本滞后问题。

检查当前Homebrew状态

打开终端，执行：
brew --version
确认已安装且可运行。若提示command not found，请先安装Homebrew。

再运行：
git -C "$(brew --repo)" remote -v
查看主仓库地址是否仍为github.com。若显示origin https://github.com/Homebrew/brew.git，则尚未换源，后续更新极可能卡在Auto-updating阶段。

强制更新Homebrew主程序

这一步更新的是brew命令本身（即/ opt/homebrew/bin/brew或/usr/local/bin/brew），不是软件包。
执行：
brew update

如果卡在==> Auto-updating Homebrew…超过3分钟无响应，立即按Ctrl + C中断。
然后手动拉取主程序更新：
git -C "$(brew --repo)" fetch origin master && git -C "$(brew --repo)" reset --hard origin/master

这步跳过自动检测逻辑，直接强制同步到远程master分支最新提交，【避免因本地HEAD detached导致brew命令异常】。

同步核心仓库与Cask仓库

方法一：逐个更新（推荐，可控性强）
① 更新homebrew/core：
git -C "$(brew --repo homebrew/core)" fetch origin master && git -C "$(brew --repo homebrew/core)" reset --hard origin/master
② 更新homebrew/cask：
git -C "$(brew --repo homebrew/cask)" fetch origin master && git -C "$(brew --repo homebrew/cask)" reset --hard origin/master

方法二：一键触发全量拉取（适合已换源用户）
brew tap-sync && brew update
该命令会遍历所有已tap仓库并fetch，但若某个第三方tap不可达，会导致整体中断——此时应改用方法一单独处理。

刷新Bottles预编译包索引

执行：
brew cleanup -s
清理旧版formula缓存，防止因本地formula.jws.json过期而无法匹配新版bottles。

然后验证Bottles源是否生效：
echo $HOMEBREW_BOTTLE_DOMAIN
应输出类似https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles。若为空，需补设：
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles' >> ~/.zshrc && source ~/.zshrc

最后执行一次完整更新：
brew update --verbose