必须先安装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）即成功。