Homebrew是macOS必备包管理工具，支持一行命令安装/升级/卸载命令行工具（如git、node）和图形应用（如VS Code），自动处理依赖与路径配置。它依赖Xcode命令行工具、正确shell环境及目录权限，安装后需验证brew --version和brew doctor，区分brew install与brew install --cask用法。
Mac用户想在终端里用一条命令就装好Git、Node.js或VS Code这类软件，不用手动下载dmg、拖进Applications、配PATH，也不用担心依赖缺失或版本冲突，就得靠Homebrew来实现。
确认系统基础环境是否就绪
Homebrew不是独立运行的程序，它踩在Xcode命令行工具、shell配置和目录权限三块基石上。缺任何一块，后续install都会卡在“command not found”或“Permission denied”。
先打开终端，依次执行两行命令：
xcode-select -p
which brew
第一行输出/Library/Developer/CommandLineTools，说明Xcode命令行工具已装好；第二行若有路径（如/opt/homebrew/bin/brew），说明已有旧版Homebrew，可跳过安装直接更新；若第二行无输出，继续下一步。
【必须做】如果xcode-select -p报错或返回空，立刻运行xcode-select --install，弹窗点“安装”，等进度条走完再验证一次——这步漏掉，后面所有brew install都会失败。
选择一种方式安装Homebrew
国内网络环境下，官方脚本大概率超时或中断，推荐优先使用镜像脚本，一步到位自动配好环境变量。
方法一：中科大镜像（响应快、稳定性高）
在终端粘贴执行：
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
运行后会出现中文菜单，输入1并回车，选中科大源；接着输入开机密码（不显示字符，输完直接回车）；脚本会自动完成下载、安装、PATH写入。
方法二：清华镜像（适合教育网或南方地区用户）
/bin/zsh -c "$(curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/install/homebrew.sh)"
这条命令不带交互菜单，执行后直接安装，无需选择，适合批量部署场景。
方法三：官方脚本（仅限能稳定访问GitHub的网络）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
注意：Apple Silicon（M1/M2/M3）机型安装后默认路径是/opt/homebrew，Intel机型是/usr/local；脚本会自动识别，你不用管。
验证并激活Homebrew
安装完成后，终端通常会提示类似这样的命令：
eval "$(/opt/homebrew/bin/brew shellenv)"
复制这整行，粘贴回车执行一次——这是让当前终端立刻识别brew命令的关键操作，不做这步，新打开的终端里brew仍不可用。
然后立即验证：
brew --version → 输出版本号（如4.3.5）即成功
brew doctor → 输出Your system is ready to brew.才算真正就绪
如果brew doctor报PATH未包含brew路径，按提示把eval命令追加到~/.zshrc里：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc
用brew install装第一个软件
现在可以正式安装软件了。记住两条核心规则：
命令行工具（如git、wget、node）用brew install xxx
图形界面应用（如Chrome、VS Code、Docker）必须加--cask参数：brew install --cask xxx
第一步：搜索确认包名
brew search git → 查看是否有git这个formula
brew search --cask visualstudiocode → 查看VS Code的准确cask名（别输成vscode，会找不到）
第二步：安装
brew install git → 安装后自动加入PATH，新开终端就能用git --version验证
brew install --cask visualstudiocode → 安装完成后App会出现在Launchpad里
第三步：验证是否生效
git --version → 输出2.x.x即成功
open -a "Visual Studio Code" → 能正常拉起程序窗口
【关键区别】brew install node装的是命令行运行时，而brew install --cask nodejs装的是官网那种带GUI安装器的桌面版——二者完全不同，别混用。
常用维护操作
装完软件不是终点，日常要用这些命令保持环境干净稳定：
更新软件列表：brew update（每次install前建议先跑一遍）
升级所有已装软件：brew upgrade（会自动跳过没更新的包）
卸载命令行工具：brew uninstall wget
卸载图形应用：brew uninstall --cask docker
清理旧版本残留：brew cleanup（省出几百MB空间，建议每月执行一次）
检查环境隐患：brew doctor（只要输出那句“ready to brew”，就说明一切正常）
