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

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

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

黑客发布于 2026/3/22更新于 2026/8/2464 浏览

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
  >> ~/.zshrc
  >> ~/.zshrc
  >> ~/.zshrc
  >> ~/.zshrc
echo
'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. 恢复官方仓库
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • C++ STL string 类从零实现详解
  • 在 Ubuntu 22.04 上安装 VMware Tools
  • OpenCode 开源 AI 编程代理实战与配置
  • VSCode 通过 SSH 远程连接 Ubuntu 配置指南
  • VS Code 在 Linux 系统上的安装配置与远程开发实战指南
  • 即梦 AI 生图进阶指南:核心参数与实战技巧
  • PyCharm 断点排查 GLM-4.6V-Flash-WEB 脚本错误
  • 基于 FPGA 的 SPI Flash 读写控制设计
  • Hello World 背后的启动逻辑
  • OpenClaw 安全崩盘:AI Agent 大规模暴露与漏洞分析
  • Kimi Code:Moonshot AI 智能编程助手及 CLI 集成
  • 基于 Python 的 YOLO 目标检测项目实战
  • 基于Python的高校毕业生招聘信息推荐系统设计与实现
  • VS Code 搭配 GitHub Copilot 实战指南:从配置到高效协作
  • VS Code 集成 MiniMax M2.1 进行 AI 编程开发指南
  • Spring Boot 4 新特性:Jackson 3 ObjectMapper 异常处理简化,无需 try-catch
  • GitHub 及 GitHub Desktop 详细使用教程
  • 字节扣子搭建大模型擂台:匿名 PK 与用户评价机制
  • 使用 AI 在 Figma 中自动生成 UI 设计稿
  • 机器人数值优化基础(一)从理论到实战

相关免费在线工具

  • 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