Homebrew在Mac上安装失败时，可依网络与芯片情况选择官方直装、国内镜像、手动配置环境变量、离线修改脚本或验证校准五种方法。
如果您尝试在Mac终端中安装Homebrew包管理器，但执行官方命令后提示命令未找到、权限拒绝或网络超时，则可能是由于网络限制、Shell环境变量未配置或芯片架构适配缺失所致。以下是多种可行的安装与环境路径设置方法：
一、官方脚本直装法（需基础网络连通）
该方法直接调用GitHub原始安装脚本，适用于能稳定访问raw.githubusercontent.com的环境，安装路径依芯片自动区分：Intel芯片默认为/usr/local/Homebrew，Apple Silicon（M系列）默认为/opt/homebrew。
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!"即表示核心安装完成。
二、国内镜像一键安装法（推荐多数用户）
该方法绕过GitHub原始域名，使用Gitee镜像源加速下载，无需额外配置hosts或代理，兼容Intel与Apple Silicon芯片，且自动处理环境变量写入。
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未加载Homebrew的执行路径，需根据芯片类型与Shell版本精准写入对应配置文件。
1、先确认当前Shell类型：执行echo $SHELL，输出为/bin/zsh（macOS Catalina 10.15+默认）或/bin/bash（旧系统）。
2、再确认芯片架构：执行uname -m，返回arm64为M系列芯片，返回x86_64为Intel芯片。
3、根据组合结果写入环境变量（任选其一）：
— M系列 + zsh：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile && source ~/.zprofile
— Intel + zsh：
echo 'eval "$(/usr/local/Homebrew/bin/brew shellenv)"' >> ~/.zprofile && source ~/.zprofile
— Intel + bash：
echo 'eval "$(/usr/local/Homebrew/bin/brew shellenv)"' >> ~/.bash_profile && source ~/.bash_profile
四、离线/受限网络安装法（公司防火墙或无外网场景）
该方法不依赖实时网络下载，通过本地修改安装脚本指向国内Git镜像仓库，适用于无法启用代理或热点的封闭环境。
1、在终端中执行：
cd ~ && curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh -o brew_install
2、用文本编辑器打开该文件：
open -e ~/brew_install
3、查找并替换两处URL：
将BREW_REPO = "https://github.com/Homebrew/brew".freeze替换为
BREW_REPO = "https://mirrors.ustc.edu.cn/brew.git".freeze
将CORE_TAP_REPO = "https://github.com/Homebrew/homebrew-core".freeze替换为
CORE_TAP_REPO = "https://mirrors.ustc.edu.cn/homebrew-core.git".freeze
4、保存文件后，在终端执行：
/usr/bin/ruby ~/brew_install
五、验证与基础校准
无论采用哪种安装方式，均需执行校验步骤确认Homebrew功能完整可用，避免因权限或路径残留导致后续包安装失败。
1、在终端输入：
brew --version，应返回类似4.3.12的版本号。
2、运行诊断命令：
brew doctor，若输出Your system is ready to brew.则表示环境健康。
3、执行一次基础更新以拉取最新公式列表：
brew update
