Apple Silicon Mac 安装 Homebrew 需选适配方法:官方脚本直装至 /opt/homebrew;国内用户推荐 Gitee 镜像一键安装并选清华源;若 brew command not found,需手动将 eval "$(/opt/homebrew/bin/brew shellenv)" 写入 ~/.zprofile 并生效。

如果您使用的是搭载 Apple Silicon(M1/M2/M3)芯片的 Mac,并希望安装 Homebrew 包管理器,则需特别注意安装路径、Shell 环境与镜像源适配问题。以下是专为 M 芯片优化的多种安装方法:
一、官方脚本直装法(适用于可直连 GitHub 的网络环境)
该方法由 Homebrew 官方维护,自动识别 Apple Silicon 架构并安装至 /opt/homebrew 目录,无需手动干预路径,但依赖 raw.githubusercontent.com 的稳定访问。
1、打开终端应用程序,可通过 Spotlight(Command + 空格)搜索“Terminal”并回车启动。
2、复制粘贴以下命令并回车执行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3、按屏幕提示输入管理员密码(输入时无可见字符,属正常现象),随后可能提示安装 Xcode 命令行工具,输入 y 并回车确认。
4、等待脚本完成下载、解压与初始化,末尾出现 "Installation successful!" 即表示核心安装完成。
二、国内镜像一键安装法(推荐中国大陆用户)
该方法采用 Gitee 托管的 HomebrewCN 脚本,内置清华大学、中科大等多源选择,自动适配 M 系列芯片路径与 zsh 配置,全程中文交互,规避 GitHub 连接失败风险。
1、在终端中执行以下命令:
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
2、出现交互式菜单后,输入数字 2 选择清华大学镜像源(响应快、稳定性高)。
3、按提示输入管理员密码,随后在选项列表中输入 5 执行全自动安装与环境变量配置。
4、安装完成后,终端将提示是否执行 source ~/.zprofile,务必立即执行该命令以使 brew 命令立即生效。
三、手动配置环境变量(解决 brew command not found)
即使安装成功,若终端仍报错 command not found: brew,说明当前 shell 未加载 M 芯片专用路径 /opt/homebrew/bin,需精准写入 zsh 配置文件。
1、确认当前 Shell 类型:执行 echo $SHELL,输出应为 /bin/zsh(macOS Catalina 及更新系统默认)。
2、确认芯片架构:执行 uname -m,返回 arm64 即为 M 系列芯片。
3、向配置文件写入环境变量:执行以下命令(单行,勿换行):
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile && source ~/.zprofile
4、验证生效:新开终端窗口,执行 brew --version,若输出版本号即表示配置成功。










