1. Homebrew 是什么Homebrew 是 macOS 系统上最受欢迎的包管理工具它让安装、更新、卸载和管理 Unix 工具变得像喝水一样简单。作为一个在 macOS 上摸爬滚打多年的开发者我可以负责任地说没有 Homebrew 的 Mac 就像没有 App Store 的 iPhone - 能用但很不方便。它的核心价值在于解决了 macOS 自带软件包老旧的问题提供了数万个经过社区验证的软件包Formula自动处理依赖关系告别手动编译安装的痛苦保持软件更新比系统自带的更及时注意虽然主要面向 macOS但 Homebrew 也能在 Linux 上运行需要额外配置2. 安装前的准备工作2.1 系统要求检查在开始之前请确认你的系统满足以下条件macOS 10.13 (High Sierra) 或更高版本已安装 Xcode 命令行工具这是必须的拥有管理员权限的账户检查命令行工具是否安装xcode-select -p如果返回类似/Library/Developer/CommandLineTools的路径说明已安装。否则需要执行xcode-select --install2.2 终端环境准备推荐使用系统自带的 Terminal.app 或更现代的替代品如 iTerm2。确保你的 shell 是 bash 或 zshCatalina 及以后版本默认使用 zsh。检查当前 shellecho $SHELL3. 正式安装 Homebrew3.1 一键安装命令官方推荐的最简单安装方式是使用这个命令/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)这个命令会检查系统环境下载最新安装脚本在 /usr/local 目录创建 Homebrew 所需的结构将 brew 命令添加到你的 PATH3.2 安装过程详解执行安装命令后你会看到类似这样的输出 Checking for sudo access (which may request your password)... Password: This script will install: /usr/local/bin/brew /usr/local/share/doc/homebrew /usr/local/share/man/man1/brew.1 ...安装过程中可能会要求你输入管理员密码按回车确认安装位置等待下载和编译完成视网络情况可能需要5-15分钟3.3 安装后配置安装完成后根据提示你需要将 Homebrew 添加到 PATH。对于 zsh 用户echo eval $(/opt/homebrew/bin/brew shellenv) ~/.zshrc source ~/.zshrc验证安装是否成功brew --version应该能看到类似Homebrew 3.6.0的版本信息。4. 基础使用指南4.1 搜索软件包在安装前可以先搜索brew search 包名例如想找 Python 相关包brew search python4.2 安装软件基本安装命令brew install 包名例如安装最常用的 wgetbrew install wget4.3 查看已安装软件列出所有通过 Homebrew 安装的软件brew list查看某个软件的信息brew info 包名4.4 更新与升级更新 Homebrew 自身和软件列表brew update升级所有已安装软件brew upgrade升级特定软件brew upgrade 包名5. 高级配置与优化5.1 更换国内镜像源如果你在国内可能会遇到下载慢的问题。可以更换为国内镜像源更换 Homebrew 核心仓库git -C $(brew --repo) remote set-url origin https://mirrors.ustc.edu.cn/brew.git更换 Homebrew-coregit -C $(brew --repo homebrew/core) remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git5.2 清理无用文件定期清理旧版本和缓存brew cleanup查看可清理的空间brew cleanup -n5.3 诊断问题如果遇到问题可以先运行brew doctor这个命令会检查你的 Homebrew 环境并给出修复建议。6. 常见问题解决6.1 权限问题如果遇到权限被拒绝的错误不要轻易使用 sudo。正确的做法是sudo chown -R $(whoami) $(brew --prefix)/*6.2 安装失败常见原因和解决方案问题现象可能原因解决方案下载超时网络连接问题更换镜像源或使用代理校验和不匹配下载文件损坏运行brew update-reset依赖缺失缺少系统库安装 Xcode 命令行工具6.3 命令找不到如果提示brew: command not found说明 PATH 设置有问题。检查你的 shell 配置文件.zshrc 或 .bash_profile是否包含eval $(/opt/homebrew/bin/brew shellenv)7. 推荐必备软件包以下是我多年使用总结的必备工具列表开发工具brew install git python nodejs效率工具brew install tree wget curl htop多媒体工具brew install ffmpeg imagemagick数据库brew install mysql postgresql redis8. 维护与卸载8.1 定期维护建议每周运行brew update brew upgrade brew cleanup8.2 完全卸载如果需要卸载 Homebrew/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)卸载后会保留之前安装的软件如需完全清理需要手动删除sudo rm -rf /usr/local/Cellar /usr/local/.git9. 使用技巧与心得批量安装可以创建一个 Brewfile然后使用brew bundle命令一次性安装多个软件查看依赖安装前用brew deps 包名查看依赖关系版本锁定如果不想某个软件自动更新可以用brew pin 包名图形界面对于喜欢 GUI 的用户可以安装brew install --cask开头的应用服务管理用brew services命令管理后台服务比原生 launchctl 更方便我在实际使用中发现保持 Homebrew 的整洁很重要。建议定期运行brew doctor不要随意使用sudo运行 brew 命令复杂的软件组合可以考虑用 Docker 容器隔离最后分享一个小技巧用brew leaves可以查看直接安装的非依赖的软件包帮助保持系统干净。
