在Mac上安装Homebrew看似简单，但新手常因PATH配置、权限等问题陷入困境。本文总结了五个极易犯的关键错误及其解决方法，旨在帮助用户避开常见陷阱，实现流畅的安装与使用体验。
智能速览
Apple Silicon Mac需手动配置PATH环境变量。
严禁使用sudo运行brew，它会破坏文件权限。
遇到问题应优先运行brew doctor进行诊断。
安装GUI应用需使用–cask标志，与命令行工具区分。
安装后务必仔细阅读Caveats（注意事项）。
定期运行brew update可避免软件包过时。
精华内容
Homebrew的安装过程暗藏玄机，许多看似无解的故障，往往源于几个基础的认知误区。了解这些错误的前因后果，是高效使用这款工具的第一步。
环境变量PATH
在Apple Silicon芯片的Mac（M1/M2等）上安装Homebrew后，输入brew命令提示“command not found”，这是最常见的问题。
根源在于，Apple Silicon Mac的Homebrew被安装到/opt/homebrew/bin路径，该路径默认未加入系统环境变量PATH中。而英特尔Mac则安装在/usr/local/bin，系统已自动包含。
解决方法是，将以下两行命令复制到终端并执行：echo ‘eval “$(/opt/homebrew/bin/brew shellenv)”’ >> ~/.zshrc 和 eval “$(/opt/homebrew/bin/brew shellenv)”。前者将配置写入shell配置文件，后者立即生效。完成后，输入brew --version验证即可。
权限的陷阱
当Homebrew操作遇到“Permission denied”错误时，凭借在Linux上的经验，很多人的第一反应是添加sudo。这是一个灾难性的错误。
Homebrew的设计初衷就是在用户权限下运行。使用sudo会创建归root用户所有的文件，导致后续的普通用户指令无法修改这些文件，从而引发一连串的权限错误，最终可能需要重装整个环境。
正确的做法是，永远不要对brew使用sudo。若已误操作，可使用sudo chown -R $(whoami) /opt/homebrew/*命令将所有权改回当前用户，然后运行brew doctor检查并修复后续问题。
自带的医生
多数初学者不知道Homebrew内置了强大的诊断工具：brew doctor。当遇到奇怪的错误或不确定安装是否正确时，应首先运行此命令。
brew doctor会全面检查系统配置、文件权限、依赖关系等，并给出具体的警告和修复建议。例如，它会提示未链接的keg、未同意的Xcode许可证等问题。
这些警告是解决问题的关键线索，而非可忽略的提示。按照brew doctor的输出顺序逐一修复，能解决超过90%的Homebrew疑难杂症，远比盲目搜索网络高效。
公式与酒桶
Homebrew管理的软件包分为两种：Formula和Cask。混淆两者是导致“找不到包”或安装后无法启动的常见原因。
Formula指的是通过编译安装的命令行工具，如Git、Node.js。Cask则是预编译好的图形界面（GUI）应用程序，如Visual Studio Code、Firefox。
安装语法不同：命令行工具使用brew install
安装后须知
成功安装一个软件包后，Homebrew会在终端输出一段“Caveats”（注意事项）。很多新手会忽略这一大段文字，但这往往是软件能正常运行的必要步骤。
例如，安装MySQL后，Caveats会提示你需要运行brew services start mysql或手动执行其他命令来启动数据库服务。若忽略这些步骤，软件虽然安装了，但无法连接或使用。
务必仔细阅读每一条Caveats，并按要求执行相关命令。这些是安装流程的一部分，而非可选的附加建议。如果关闭了终端，可通过brew info
掌握这几点，Homebrew的使用体验将大为改观，从挫折变为顺遂。它本质上是一款设计精良的工具，多数问题源于对规则的忽视。养成良好习惯，如定期更新和善用brew doctor，能让Mac环境管理事半功倍。你还有哪些使用心得？
