跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / Bash

Mac 安装 Homebrew 慢?中科大镜像源加速配置教程

介绍如何在 Mac 上通过中科大镜像源快速安装 Homebrew 并配置永久加速。针对国内网络访问 GitHub 速度慢、超时等问题,提供环境变量设置、Git 仓库地址更换及 PATH 配置步骤。包含 Apple Silicon 与 Intel 芯片的不同处理方式,以及常用命令速查和常见问题解决方案,帮助开发者实现秒装软件。

黑客发布于 2026/3/22更新于 2026/6/434 浏览

Mac 安装 Homebrew 慢?中科大镜像源加速配置教程

一、为什么你需要换源?

Homebrew 默认从 GitHub 拉取数据,在国内访问经常遇到以下问题:

  • 下载速度只有几 KB/s
  • Operation timed out 超时报错
  • 404 Not Found 镜像失效
  • 一个软件装半小时,效率低下

解决方案:使用国内高校镜像源,中科大(USTC)是国内最稳定、更新最及时的镜像之一。

二、极速安装步骤(全程 3 分钟)

Step 1:设置中科大镜像环境变量

打开终端,一次性复制执行:

export HOMEBREW_INSTALL_FROM_API=1
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"

Step 2:运行安装脚本

/bin/bash -c "$(curl -fsSL https://mirrors.ustc.edu.cn/misc/brew-install.sh)"

等待安装完成,看到 ==> Installation successful! 即表示成功。

Step 3:添加到 PATH(Apple Silicon Mac 必做)

M1/M2/M3 芯片用户执行:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

Intel Mac 通常会自动配置好,可跳过此步。

Step 4:验证安装

brew --version

输出类似 Homebrew 4.x.x 即表示成功!

三、配置永久镜像源(一劳永逸)

上面 Step 1 的变量重启后会失效,以下步骤永久生效:

3.1 写入环境变量到 zshrc

echo 'export HOMEBREW_INSTALL_FROM_API=1' >> ~/.zshrc
echo  >> ~/.zshrc
  >> ~/.zshrc
  >> ~/.zshrc
  >> ~/.zshrc
'export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"'
echo
'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"'
echo
'export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"'
echo
'export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"'

3.2 更换 Git 仓库地址(加速 brew update)

# 更换 brew 本身仓库
git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git
# 更换核心软件库
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git
# 更换 GUI 软件库
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git
# 更新索引
brew update

3.3 验证配置是否成功

brew config | grep -E "(HOMEBREW_BREW_GIT_REMOTE|HOMEBREW_CORE_GIT_REMOTE|HOMEBREW_BOTTLE_DOMAIN)"

看到中科大地址即表示配置成功。

四、常用命令速查表

命令作用
brew install 软件名安装软件(如 brew install wget)
brew uninstall 软件名卸载软件
brew search 关键词搜索软件包
brew list查看已安装软件
brew update更新软件列表
brew upgrade升级所有软件
brew doctor诊断问题
brew cleanup清理旧版本缓存

安装示例:

# 一口气安装开发必备工具
brew install git node python wget tree htop

五、常见问题 FAQ

Q1:安装时提示 curl: (22) The requested URL returned error: 404 A:说明该镜像的 install.sh 脚本路径已变更,建议换用本文提供的中科大或阿里云方案。

Q2:brew 命令找不到? A:Apple Silicon Mac 需要手动添加 PATH,执行:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

Q3:如何恢复官方源? A:

# 删除环境变量
sed -i '/HOMEBREW/d' ~/.zshrc
# 恢复官方仓库
git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew.git
git -C "$(brew --repo homebrew/core)" remote set-url origin https://github.com/Homebrew/homebrew-core.git
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://github.com/Homebrew/homebrew-cask.git
source ~/.zshrc && brew update

目录

  1. Mac 安装 Homebrew 慢?中科大镜像源加速配置教程
  2. 一、为什么你需要换源?
  3. 二、极速安装步骤(全程 3 分钟)
  4. Step 1:设置中科大镜像环境变量
  5. Step 2:运行安装脚本
  6. Step 3:添加到 PATH(Apple Silicon Mac 必做)
  7. Step 4:验证安装
  8. 三、配置永久镜像源(一劳永逸)
  9. 3.1 写入环境变量到 zshrc
  10. 3.2 更换 Git 仓库地址(加速 brew update)
  11. 更换 brew 本身仓库
  12. 更换核心软件库
  13. 更换 GUI 软件库
  14. 更新索引
  15. 3.3 验证配置是否成功
  16. 四、常用命令速查表
  17. 一口气安装开发必备工具
  18. 五、常见问题 FAQ
  19. 删除环境变量
  20. 恢复官方仓库
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • OpenClaw 本地 AI 助手:架构、功能与适用场景解析
  • ClawdBot 多语言翻译 Telegram 机器人部署与配置指南
  • JavaScript 逆向断点调试与前端加密对抗实战
  • Dify 平台 Webhook 机制配置与使用场景
  • Python 计算 2025 中秋月相与趣味算法实战
  • 职场边界感:平衡工作、生活与职业发展的关键
  • JDK21虚拟线程(Virtual Threads):轻量级并发的底层实现深度解析
  • 浏览器 F5 刷新机制深度解析
  • OpenClaw 浏览器控制:利用 Chrome Debug 实现持久化登录与自动化
  • C++ 核心面试题总结:语法、内存与类机制详解
  • Windows 本地运行 DeepSeek:Docker 与 Ollama 实战指南
  • Java SpringBoot 集成 OCR 构建企业级中间件服务
  • Meta Llama 4 Scout MoE 架构与性能深度解析
  • Java 25 LTS 下载、安装与配置指南(以 IntelliJ IDEA 为例)
  • 栈相关算法实战:模板实现与有效括号判定
  • Windows 11 安装 JDK 25:下载、配置与验证
  • GitHub 上最受欢迎的 7 大 Claude Skills 开源 AI 技能库
  • OpenCode 与 OpenClaw 本地 AI 智能体安装配置指南
  • 设计模式:策略模式详解与实战
  • 哈希表进阶:用哈希桶封装 unordered_set 和 unordered_map 及迭代器实现

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online