homebrew核心库损坏表现为brew update失败、install报“no available formula”或“fatal: not a git repository”等git错误；修复应先用brew tap --repair和brew update --force自动恢复，无效时再手动用中科大镜像源重建homebrew-core仓库并配置镜像源。
homebrew 核心库（homebrew-core）损坏通常表现为 brew update 失败、brew install 报错“no available formula”、或执行命令时提示 fatal: not a git repository 等 git 相关错误。这不是 homebrew 本身崩溃，而是它依赖的本地 git 仓库状态异常。修复重点在于重置或重建 homebrew-core 仓库，同时保留已安装包和配置。
确认是否真为 core 损坏
先运行以下命令快速判断：
-
brew doctor—— 查看是否有homebrew-core相关警告（如 “The following directories are not writable” 或 “Your homebrew-core is outdated”） -
ls -la $(brew --repo homebrew/core)—— 检查该路径下是否存在.git目录；若缺失或为空，基本可确认损坏 -
cd $(brew --repo homebrew/core) && git status—— 若报错not a git repository或error: object file ... is empty，即为 Git 仓库损坏
用 brew 命令自动修复（推荐首选）
Homebrew 自带恢复机制，优先尝试原生命令修复：
- 执行
brew tap --repair：强制重新初始化所有已启用的 tap，包括homebrew/core - 若失败，再运行
brew update --force：跳过本地检查，强制从远程拉取最新索引 - 完成后验证：
brew search wget应能正常返回结果，brew --version不报错
手动替换 homebrew-core 仓库（网络稳定时）
当自动修复无效，或 .git 目录彻底丢失，可安全重建核心库：
- 备份当前目录（可选）：
mv $(brew --repo homebrew/core) $(brew --repo homebrew/core).bak - 用国内镜像源克隆干净仓库（以中科大源为例）：
git clone https://mirrors.ustc.edu.cn/homebrew-core.git $(brew --repo homebrew/core) - 进入目录并检出稳定分支：
cd $(brew --repo homebrew/core) && git checkout master - 刷新缓存：
brew update
配合环境变量避免重复出错
为防止后续因网络问题再次损坏，建议提前配置镜像源：
- 设置 Homebrew 更新源：
git -C $(brew --repo) remote set-url origin https://mirrors.ustc.edu.cn/brew.git - 设置 core 源：
git -C $(brew --repo homebrew/core) remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git - 验证配置：
git -C $(brew --repo homebrew/core) remote -v应显示镜像地址
整个过程不删除已安装软件，也不会影响 brew services 或自定义 tap。只要 Git 仓库恢复完整，所有功能立即回归正常。
