Homebrew更换镜像源后仍报错，主因是换源仅解决网络问题，权限、环境变量、Tap子仓库地址及架构适配等环节仍可能出错；需按“Permission denied”“command not found”“Failed to connect”“arm64误判”四类错误分别排查修复。
homebrew 更换镜像源后仍报错，通常不是“换源没生效”，而是换源只是解决了网络层问题，其他环节（权限、路径、架构适配、环境变量）可能仍存在隐患。下面分四类典型场景，直接对应你终端里看到的错误信息。
一、报错含 “Permission denied” 或 “not writable”
说明当前用户对 Homebrew 目录无写权限，即使源换了也进不去。常见于曾用 sudo 执行过 brew 命令，或系统升级后目录归属被重置。
- 先确认 Homebrew 安装位置：Apple Silicon（M1/M2/M3）是 /opt/homebrew，Intel 是 /usr/local
- 执行命令修复权限（以 Apple Silicon 为例）：
sudo chown -R $(whoami) /opt/homebrew - 再补一句确保可写：
chmod -R u+w /opt/homebrew - 验证是否修复成功：
ls -ld /opt/homebrew，输出中第一组权限位应含 w（如 drwxr-xr-x）
二、报错含 “command not found: brew” 或 “No such file or directory”
说明终端找不到 brew 命令，本质是环境变量未正确配置，和镜像源无关。
- 先查 brew 实际路径：
ls /opt/homebrew/bin/brew（Apple Silicon）或 ls /usr/local/bin/brew（Intel） - 若存在，把对应路径加入 shell 配置文件：
→ Zsh（macOS Catalina 及之后默认）：编辑 ~/.zshrc，加一行：
export PATH="/opt/homebrew/bin:$PATH"
→ Bash（旧系统）：编辑 ~/.bash_profile，加同上内容 - 保存后运行：
source ~/.zshrc（或 source ~/.bash_profile） - 再试：brew --version
三、报错含 “Failed to connect to objects.githubusercontent.com” 或 “Cloning into …” 卡住
说明换源只改了主仓库（brew），但 homebrew-core 和 homebrew-cask 这两个核心 Tap 仍试图从 GitHub 拉取，需单独切换。
- 检查当前 tap 地址：
git -C $(brew --repo homebrew/core) remote get-url origin - 若显示 GitHub 地址，立即切为清华镜像：
git -C $(brew --repo homebrew/core) remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git - 同样处理 cask：
git -C $(brew --repo homebrew/cask) remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git - 最后强制更新：
brew update（首次可能较慢，但不再卡在 GitHub）
四、Apple Silicon（M1/M2/M3）上提示 “brew is not installed for arm64” 或命令不响应
这是架构误判导致的典型问题——系统以为你在 Intel 环境下运行，却调用了 x86_64 版本的工具链。
- 先确认终端架构：
arch 应输出 arm64；若输出 i386，说明你开了 Rosetta 模式 - 关闭 Rosetta：右键终端 App → “显示简介” → 取消勾选 “使用 Rosetta 打开” → 重启终端
- 重新安装 Homebrew（务必用 arm64 终端执行）：
/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"（HomebrewCN 自动适配架构） - 装完检查：
file $(which brew) 应显示 “Mach-O 64-bit executable arm64”
