遇到GitHub原始资源访问受阻时,可用三种国内镜像安装Homebrew:一、一键交互式(推荐新手,自动适配芯片并三选镜像);二、中科大直连(适合已装CLT的M系列芯片用户);三、本地脚本离线安装(适用于防火墙或断网环境)。

如果您在 macOS 上尝试安装 Homebrew,但遇到官方源下载缓慢、连接超时或 curl: (7) Failed to connect to raw.githubusercontent.com port 443 等错误,则说明 GitHub 原始资源访问受阻。以下是三种经实测验证、适配 Apple Silicon(M1/M2/M3)与 Intel 芯片的国内镜像安装方法:
一、一键式交互镜像安装(推荐新手)
该方法由 HomebrewCN 社区维护,自动检测芯片架构(/opt/homebrew 或 /usr/local 路径),并提供中科大、清华、阿里云三选一镜像源,全程无需手动修改环境变量或配置文件。
1、打开终端(Terminal),可通过 Spotlight 搜索「终端」并回车启动。
2、粘贴并执行以下完整命令(整行复制,勿换行):
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
3、脚本运行后,将显示镜像源选项列表(例如:1-中科大、2-清华、3-阿里云),输入对应数字并回车确认。
4、提示输入密码时,键入当前用户管理员密码(输入过程无光标反馈,输完直接回车)。
5、等待自动完成安装,包括 Command Line Tools 检查、Git 初始化、核心仓库克隆及路径适配。
二、极简直连中科大镜像安装(适合已装 CLT 的 M 系列芯片用户)
跳过交互环节,强制使用中科大镜像直连 brew 和 homebrew-core 仓库,规避 GitHub 全链路阻塞,适用于已预装 Xcode 命令行工具的纯净系统环境。
1、确认 Xcode 命令行工具已就绪:在终端中执行 xcode-select --install,若弹出提示则点击安装并完成协议确认;若返回 /Library/Developer/CommandLineTools,则跳过此步。
2、执行中科大直连安装命令:
/usr/bin/ruby -e "$(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/install)"
3、若卡在 Cloning into '/usr/local/Homebrew/Library/Taps/homebrew/homebrew-core',立即按 Control + C 中断。
4、中断后依次执行以下三行命令补全核心仓库:
cd "$(brew --repo)/Library/Taps/" && mkdir homebrew && cd homebrew
5、执行克隆:
git clone git://mirrors.ustc.edu.cn/homebrew-core.git
三、本地脚本离线安装(适用于企业防火墙/断网/策略限制环境)
当 curl 无法联网或终端被禁止执行远程脚本时,可先将安装脚本下载至本地,检查并替换源地址后再执行,全过程脱离网络依赖,安全可控。
1、在浏览器中打开链接:
https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh
2、右键网页空白处,选择「另存为」,保存路径设为桌面,文件名设为 Homebrew.sh。
3、打开终端,进入桌面目录:
cd ~/Desktop
4、赋予脚本执行权限:
chmod +x Homebrew.sh
5、编辑脚本,将其中所有 https://github.com 或 raw.githubusercontent.com 替换为 https://mirrors.ustc.edu.cn 对应路径(如需,可参考脚本内注释定位源地址字段)。
6、执行本地安装:
./Homebrew.sh

















