homebrew是macos程序员必装的包管理器，需先安装xcode命令行工具，再通过官方或国内镜像脚本安装，配置对应芯片架构的环境变量，并运行brew doctor、brew update及brew install wget验证环境。
如果您在 macOS 系统上需要便捷地安装、管理和更新命令行工具与开源软件，则 Homebrew 是程序员必装的包管理器。以下是完成 Homebrew 安装及基础环境配置的完整操作步骤：
一、安装前准备：确认并安装 Xcode 命令行工具
Xcode 命令行工具是 Homebrew 运行所必需的底层依赖，提供编译器（如 clang）、make、git 等关键组件。未安装会导致后续脚本执行失败或中断。
1、打开“终端”应用（可通过 Spotlight 搜索 Terminal 打开）。
2、输入以下命令并回车：xcode-select --install。
3、弹出窗口中点击“安装”，等待进度条完成，关闭窗口。
4、运行 xcode-select -p 验证安装结果，正常输出应为 /Library/Developer/CommandLineTools 或类似路径。
二、使用官方脚本安装 Homebrew（适用于 Intel 与 Apple Silicon）
该方法直接调用 Homebrew 官方维护的安装脚本，兼容 macOS 12 及以上系统，安装路径自动适配芯片架构（Intel 默认为 /usr/local，Apple Silicon 默认为 /opt/homebrew）。
1、在终端中执行以下命令：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
2、按提示输入当前用户密码（输入时无可见字符，输完直接回车）。
3、安装过程中出现确认提示时，按回车继续。
4、安装完成后，运行 brew --version 查看版本号；若返回类似 Homebrew 4.2.15 的输出，表示安装成功。
三、使用国内镜像一键安装（推荐网络受限环境）
当官方脚本因 GitHub 域名解析或 CDN 访问缓慢导致超时或中断时，可采用由中科大、清华等高校维护的国产镜像安装脚本，全程走国内服务器，无需代理。
1、在终端中执行以下命令：/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"。
2、脚本启动后，根据提示选择镜像源编号（例如输入 1 选择中科大源）并回车。
电脑手机电子配件电子商城网站模板是一款提供手机、手表、电脑等电子配件和设备的电子商城宣传网站模板下载。提示：本模板调用到谷歌字体库，可能会出现页面打开比较缓慢。
3、输入开机密码（即系统登录密码），脚本将自动完成下载、解压、权限设置与路径初始化。
4、安装结束后，重启终端或运行 source ~/.zprofile（zsh 用户）或 source ~/.bash_profile（bash 用户）加载新环境变量。
5、执行 brew -v 验证是否生效。
四、M1/M2/M3 芯片 Mac 的专用安装路径配置
Apple Silicon 设备默认将 Homebrew 安装至 /opt/homebrew，但系统 shell 不会自动识别该路径下的 brew 命令，需手动注入环境变量。
1、确认当前 shell 类型：运行 echo $SHELL，输出 /bin/zsh 表示使用 zsh（macOS Catalina 及以后默认），输出 /bin/bash 则为 bash。
2、向对应配置文件追加环境声明：若为 zsh，执行 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile；若为 bash，执行 echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.bash_profile。
3、立即生效配置：运行 eval "$(/opt/homebrew/bin/brew shellenv)"（Apple Silicon）或 eval "$(/usr/local/bin/brew shellenv)"（Intel）。
4、验证路径是否生效：运行 which brew，正确输出应为 /opt/homebrew/bin/brew 或 /usr/local/bin/brew。
五、安装后验证与基础检查
Homebrew 安装完成后必须执行诊断命令，检测是否存在权限异常、路径冲突或残留旧版本干扰，避免后续 brew install 失败。
1、运行 brew doctor，观察输出内容。
2、若出现红色警告（如 Warning: /usr/local is not writable），则需修复目录权限：执行 sudo chown -R $(whoami) /usr/local（Intel）或 sudo chown -R $(whoami) /opt/homebrew（Apple Silicon）。
3、运行 brew update 同步公式仓库，首次执行可能耗时较长，请勿中断。
4、执行 brew install wget 测试安装流程是否完整，成功后可运行 wget --version 验证二进制可用性。
