Homebrew镜像源拼写错误排查需用命令逐层验证：先查brew本体仓库URL（cd $(brew --prefix) && git remote get-url origin），再验homebrew-core地址（brew tap-info homebrew/core --verbose | grep "URL:"），接着确认bottle源与API域名（brew config | grep HOMEBREW_BOTTLE_DOMAIN / HOMEBREW_API_DOMAIN），最后检查环境变量是否正确加载（env | grep HOMEBREW_）。
排查 homebrew 镜像源地址拼写错误，关键不是“猜哪里写错了”，而是用几条简单命令快速验证每个环节的真实地址和响应状态。拼写错误通常藏在 git 仓库 url、api 域名或环境变量里，肉眼难发现，但终端能直接告诉你它到底连的是什么、能不能通。
检查当前生效的 brew 本体仓库地址
Homebrew 自身是个 Git 仓库，它的远程地址决定了 clone 和 update 走哪条路。拼错这里，后续全卡住。
- 进入 Homebrew 安装目录（Apple Silicon 是 /opt/homebrew，Intel 是 /usr/local）
- 执行：
cd $(brew --prefix) && git remote get-url origin - 正常应输出类似：
https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git（清华源）
或
https://gitee.com/mirrors/homebrew-brew.git（Gitee 镜像） - 如果看到 github.com/Homebrew/brew 或含拼写错误（比如 tuna.tsinghua.edu.cn/git/homebrew/brew 缺少末尾 .git），就是源头错了。
验证 homebrew-core 等核心 tap 的远程地址
软件列表（formula）来自 homebrew-core，它也是独立 Git 仓库，地址常被单独配置，也容易拼错。
- 运行：
brew tap-info homebrew/core --verbose | grep "URL:" - 输出应为镜像地址，例如：
URL: https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git - 常见拼写陷阱：
• 把 homebrew-core 写成 homebrew-coree 或 homebrew_core
• 漏掉 .git 后缀（Git 会报 Repository not found）
• 把 tuna.tsinghua.edu.cn 错打成 tuna.tsinghua.edu.cn（看似一样，实则多空格或全角字符）
确认 bottle 下载源和 API 域名是否可访问
安装软件时下载二进制包（bottle）和获取元数据，依赖两个独立域名：一个是 ghcr.io 或镜像替代地址，另一个是 formulae.brew.sh 或其镜像。拼错任一，brew install 就会报 Download failed 或 JSON_DOMAIN timeout。
- 查当前 bottle 源：
brew config | grep HOMEBREW_BOTTLE_DOMAIN
应显示类似：
HOMEBREW_BOTTLE_DOMAIN: https://mirrors.aliyun.com/homebrew-bottles（阿里云）或
HOMEBREW_BOTTLE_DOMAIN: https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles - 查 API 域名：
brew config | grep HOMEBREW_API_DOMAIN
国内常用：
HOMEBREW_API_DOMAIN: https://mirrors.tuna.tsinghua.edu.cn/homebrew-api - 手动测试这些地址是否可解析、可连通：
curl -I -s https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles | head -1
返回 HTTP/2 200 表示地址正确且服务在线；若报 Could not resolve host，说明域名拼错或网络不通。
检查 shell 配置文件里的环境变量赋值
很多人把镜像地址写进 ~/.zshrc，但用了等号前后空格、引号不闭合、或变量名写错，导致实际没生效。
- 运行：
env | grep HOMEBREW_
看输出中是否有你设置的变量（如 HOMEBREW_BOTTLE_DOMAIN），且值是你预期的完整 URL。 - 如果没出现，说明变量根本没加载成功。检查 ~/.zshrc 中的写法是否规范，例如：
✅ 正确：
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.aliyun.com/homebrew-bottles"
❌ 常见错误：
set HOMEBREW_BOTTLE_DOMAIN=https://...（应为 export）
export HOMEBREW_BOTTLE_DOMAIN = "https://..."（等号两边不能有空格）
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.aliyun.com/homebrew-bottles（引号没闭合）
