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，若输出版本号即表示配置成功。
