必须先安装Xcode命令行工具,再执行Homebrew安装脚本,最后配置对应shell的PATH;Apple Silicon装至/opt/homebrew,Intel装至/usr/local,验证用brew --version。

苹果笔记本(Apple Silicon 或 Intel Mac)安装 Homebrew 包管理器,是后续安装 VSCode、Helm、t3code 等开发工具的前提,必须在终端中以非 root 权限完成,且需确保系统已启用命令行工具与必要权限。
确认 Xcode 命令行工具已就绪
打开终端,执行:xcode-select --install。若弹出窗口提示“未安装”,点击“安装”并等待完成;若返回 xcode-select: error: command not found,说明系统未预装 CLI 工具,需先从 Apple 开发者网站下载对应 macOS 版本的「Command Line Tools」安装包手动安装。
这一步跳过会导致后续 brew 安装失败,因为 Homebrew 依赖 clang、git、make 等底层工具。
下载并运行 Homebrew 安装脚本
在终端中粘贴并执行以下命令:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
脚本会自动检测芯片架构(Apple Silicon → 安装到 /opt/homebrew;Intel → 安装到 /usr/local),并请求你输入管理员密码。注意:密码输入时无回显,输完直接按回车。
【必须等待脚本完全退出再进行下一步,中途关闭终端会导致安装中断且残留不完整目录】
配置终端 shell 的 PATH
根据你的 shell 类型执行对应操作:
① 若使用 zsh(macOS Catalina 及之后默认):运行 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile → 执行 source ~/.zprofile。
② 若使用 bash(旧系统或手动切换):运行 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.bash_profile → 执行 source ~/.bash_profile。
验证是否生效:新开一个终端窗口,输入 brew --version。显示版本号(如 4.3.5)即成功。











