mac安装homebrew超时95%因github域名访问不稳定,推荐用清华或中科大镜像源一键安装;需先装xcode命令行工具,关闭代理和防火墙可辅助解决。
mac 安装 homebrew 时提示网络连接超时,95% 的情况不是系统或硬件问题,而是因为安装脚本默认从 github 的 raw.githubusercontent.com 和 objects.githubusercontent.com 下载资源,这两个域名在国内访问极不稳定——常被限速、dns 污染或直接中断。不用重装系统,也不用折腾代理,换国内镜像源就能解决。
用清华镜像源一键安装(推荐新手)
这是最直接、成功率最高的方法,全程自动替换源、配置环境变量、克隆核心仓库:
- 打开终端,粘贴执行这行命令:
/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)" - 提示选择镜像源时,输入 1(中科大)或 2(清华),两者都稳定,清华更新略快
- 输入开机密码授权,等待自动完成(约 2–5 分钟)
- 完成后重启终端,运行
brew --version验证是否成功
手动修改安装脚本(适合想了解原理的用户)
如果你希望控制每一步,可下载官方脚本后本地替换地址:
GitHub 智能代码审查与 CI/CD 自动化工作流。收到 PR 或代码提交时,自动进行 AI 代码审查(bug/安全/逻辑),并根据审查结果智能生成或推荐 GitHub Actions 工作流。触发词:代码审查、review PR、生成 CI/CD、GitHub Actions。
- 先下载脚本:
curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh -o install.sh - 用
nano install.sh打开,搜索BREW_REPO=,找到类似这行:#BREW_REPO="https://github.com/Homebrew/brew" - 删掉前面的
#,并改为:BREW_REPO="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git" - 保存退出(
Ctrl+O → Enter → Ctrl+X),再执行:chmod +x install.sh && ./install.sh
别忘了前置检查:Xcode 命令行工具
很多“超时”其实是卡在前置依赖上,尤其是没装命令行工具时,系统会尝试弹窗下载十几 GB 的 Xcode——但弹窗可能被挡住、被拒绝或下载失败:
- 先运行:
xcode-select --install,等弹窗出现并确认安装 - 装完后验证:
xcode-select -p,正常应输出/Library/Developer/CommandLineTools - 如果已装过完整版 Xcode,也建议运行:
sudo xcode-select --reset确保路径正确
其他辅助手段(按需尝试)
如果上述方法仍不奏效,再排查这些常见干扰项:
- 关掉代理或科学上网工具:部分代理会干扰 Git 协议或 HTTPS SNI,反而导致连接失败
-
临时禁用防火墙/杀毒软件:尤其某些国产安全软件会拦截
git或curl连接 -
刷新 DNS 缓存:终端运行
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder - 避免在公司/学校网络下安装:这类网络常限制 GitHub 域名,换成手机热点试试










