homebrew 权限错误源于 /usr/local 或其子目录所有权被改为非当前用户，需用 sudo chown -r $(whoami) /usr/local/* 等命令修复归属，并验证 brew doctor 无权限警告；apple silicon 用户应改用 /opt/homebrew 路径。
Homebrew 在 macOS 上出现权限错误，通常是因为 /usr/local 或其子目录（如 /usr/local/bin、/usr/local/share、/usr/local/lib 等）的所有权被意外更改为非当前用户，或被 sudo 操作干扰。Homebrew 设计上**不依赖 sudo**，它要求这些路径由当前用户完全拥有，否则会报类似 Permission denied、cannot be updated 或 brew doctor 提示“invalid permissions”等错误。
确认当前用户的 Homebrew 目录所有权
运行以下命令查看关键路径归属：
ls -ld /usr/local /usr/local/bin /usr/local/share /usr/local/lib /usr/local/opt /usr/local/etc- 正常输出中每行开头应类似
drwxr-xr-x 12 yourusername admin ...，即 owner 是你的用户名（不是root或其他用户） - 若看到
root:wheel或其他用户，说明所有权已偏离
安全修复 /usr/local 及其子目录所有权
仅需将相关目录递归归属还给当前用户（无需 root 权限）：
- 执行：
sudo chown -R $(whoami) /usr/local/* - 再补全顶层：
sudo chown $(whoami) /usr/local - 注意：不要对
/usr/local执行chown -R（避免误改内部某些第三方工具的私有子目录），用/usr/local/*更稳妥 - 如果曾手动用
sudo brew install，可能还影响/opt/homebrew（Apple Silicon）或/usr/local/Homebrew（Intel），同样归属回当前用户：sudo chown -R $(whoami) $(brew --prefix)/*
验证并清理残留权限问题
修复后务必验证并重置可能损坏的状态：
- 运行
brew doctor—— 应无“permissions”类警告；若有“unbrewed”提示，属正常（指非 Homebrew 安装的文件），可忽略 - 更新一次：
brew update，确认不再报错 - 如之前因权限问题中断过安装，可清理缓存：
brew cleanup和rm -rf $(brew --cache) - 避免未来再出问题：永远不用
sudo brew；安装脚本若提示需 sudo，应先查清是否真需系统级操作（多数情况不需要）
Apple Silicon（M1/M2/M3）额外注意点
ARM 架构 Mac 默认将 Homebrew 安装到 /opt/homebrew，而非 /usr/local：
- 检查路径：
brew --prefix，返回/opt/homebrew即为 ARM 版 - 对应修复命令改为：
sudo chown -R $(whoami) /opt/homebrew/*和sudo chown $(whoami) /opt/homebrew - 确保 shell 配置（如
~/.zshrc）中PATH包含/opt/homebrew/bin，否则命令不可见
