Homebrew安装需先装Xcode命令行工具，再执行官方脚本；使用brew update/install/list/upgrade/uninstall等命令管理软件；卸载运行官方卸载脚本并确认y；国内用户可换中科大或清华镜像源；PATH异常时需修改配置文件并修复权限。
一、安装Homebrew
Homebrew依赖终端执行脚本完成初始化，需确保系统已安装Xcode命令行工具并具备管理员权限。安装过程会自动创建/usr/local/bin/brew等核心路径，并校验依赖完整性。
1、打开“终端”应用（可通过Spotlight搜索Terminal或前往“应用程序→实用工具”）。
2、在终端中输入以下命令以安装Xcode命令行工具（如尚未安装）：
/usr/bin/xcode-select --install
3、按提示点击“安装”并等待完成，关闭弹窗后继续下一步。
4、执行官方安装脚本：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
5、当提示输入密码时，输入当前用户开机密码（输入过程不显示字符，直接回车确认）。
6、等待终端输出“Installation successful!”，随后运行brew --version验证是否返回版本号。
二、使用Homebrew管理软件
安装完成后，brew通过统一命令接口处理软件生命周期，所有操作均在终端中执行，无需图形界面干预。
1、更新Homebrew自身及软件包索引：
brew update
2、搜索指定名称的软件包（例如查找wget）：
brew search wget
3、安装软件包（例如安装git）：
brew install git
4、查看当前已安装的所有软件包：
brew list
5、升级所有已安装软件至最新版本：
brew upgrade
6、卸载指定软件包（例如卸载curl）：
brew uninstall curl
7、检查系统配置是否存在潜在冲突：
brew doctor
8、清理旧版本缓存以释放磁盘空间：
brew cleanup
三、卸载Homebrew（完全清除）
卸载操作将递归删除/usr/local下所有Homebrew相关文件、目录及Git仓库，不可逆，执行前建议备份自定义Formula或Cellar中重要数据。
1、打开终端应用。
2、执行官方卸载脚本：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
3、当提示“Continue? [y/N]”时，输入y并回车确认执行卸载。
4、输入当前用户密码完成权限校验。
5、等待终端输出“Homebrew uninstalled successfully.”。
6、手动验证是否残留：
which brew
若无任何输出，则表示brew命令已不可用，卸载完成。
四、国内网络环境下的替代安装方式
当官方GitHub源因网络波动无法连接时，可切换至国内镜像源加速安装过程，该方式不改变Homebrew功能逻辑，仅替换初始脚本下载地址。
1、打开终端应用。
2、执行中科大镜像源安装命令：
/bin/zsh -c "$(curl -fsSL https://mirrors.ustc.edu.cn/brew-install/install.sh)"
3、或执行清华镜像源安装命令：
/bin/zsh -c "$(curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.sh)"
4、后续步骤与标准安装一致，包括密码输入、路径确认及brew --version验证。
五、权限与路径异常修复方法
若执行brew命令时提示“command not found”或“Permission denied”，通常因PATH未包含/usr/local/bin或目录所有权异常所致，需分别修正。
1、检查当前shell配置文件（zsh用户为~/.zshrc，bash用户为~/.bash_profile）：
cat ~/.zshrc | grep "/usr/local/bin"
2、若无输出，向配置文件追加PATH声明：
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
3、重新加载配置：
source ~/.zshrc
4、修复/usr/local目录权限（需管理员密码）：
sudo chown -R $(whoami) /usr/local
5、重新运行brew doctor确认状态正常。
