macOS Homebrew 镜像源怎么适配国内网络环境-Mac OS-PHP中文网

homebrew国内卡顿需同步替换三类地址：安装脚本（raw.githubusercontent.com）、仓库（github.com）、预编译包（ghcr.io）均指向清华或中科大等国内镜像，并按芯片架构（arm64/x86_64）选择对应路径及配置。

homebrew 在国内用得卡，不是它本身有问题，而是默认所有下载地址都指向海外服务器——raw.githubusercontent.com、github.com、ghcr.io 这几个关键节点在国内访问极不稳定。适配国内网络环境，核心就一件事：把这三类请求全部切到国内镜像源，而不是只改其中一两个。

确认芯片架构再动手
Apple Silicon（M1/M2/M3/M4）和 Intel Mac 的安装路径、命令前缀完全不同。M 系列默认装在 /opt/homebrew，Intel 默认在 /usr/local。如果脚本或命令里硬写路径却没匹配芯片，会直接报错 No such file or directory。所以第一步永远是运行：

arch

看到 arm64 就是 M 芯片，看到 x86_64 就是 Intel。后续所有配置都要按这个来。

一键安装推荐用 HomebrewCN 脚本
这是目前最省心、适配最全的方案，自动识别芯片、自动选镜像、自动清理残留。打开终端粘贴执行：

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

运行后会提示选镜像源（1 中科大、2 清华、3 阿里云），输入数字回车即可。它会自动完成：

替换 brew 本体仓库地址
替换 homebrew-core 和 homebrew-cask 的 git 地址
配置 HOMEBREW_BOTTLE_DOMAIN 指向国内 bottle 下载地址
补全环境变量（如 PATH）

手动换源要覆盖三个环节
如果已装好 brew 但速度仍慢，说明只换了部分源。必须同步调整以下三项：

核心仓库地址（git remote）

cd "$(brew --repo)"
git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git
cd "$(brew --repo)/Library/Taps/homebrew/homebrew-core"
git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
cd "$(brew --repo)/Library/Taps/homebrew/homebrew-cask"
git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git

Bottle 下载地址（二进制包）
在 ~/.zshrc 或 ~/.bash_profile 末尾添加：
```
export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles
```
然后运行 source ~/.zshrc 生效。

macOS Notes
通过 AppleScript 创建、读取、搜索及管理 macOS 备忘录。适用于用户要求记笔记、记录事项、保存想法、创建会议记录等场景。

下载
API 元数据地址（Homebrew 4.x 必须）
同样在 shell 配置文件中追加：
```
export HOMEBREW_API_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-api
```