macOS 多用户共用 Homebrew 需统一安装路径、设 admin 组权限、各用户独立配置 PATH 与补全，禁止随意 install/upgrade，推荐由指定运维用户统一维护。
在 macos 中让多个用户安全、稳定地共用 homebrew，关键不是“装一次大家都能用”，而是通过权限解耦 + 路径统一 + 配置隔离来实现。默认安装方式（比如某用户用 `brew install` 装在 `/usr/local` 或 `/opt/homebrew`）会把目录所有权和权限绑定到该用户，其他用户运行 `brew` 时大概率遇到 permission denied、database is locked 或 cellar permissions mismatch 等错误。
统一安装路径并设置组权限
Homebrew 多用户共用的前提是：所有用户对 Homebrew 根目录及其子目录有读、写、执行（进入目录）权限，但又不依赖单个用户的家目录。操作分两步：
- 确定硬件架构：Apple Silicon（M1/M2/M3）用
/opt/homebrew；Intel Mac 用/usr/local - 用管理员身份创建目录并设为
admin组可写：sudo mkdir -p /opt/homebrew sudo chgrp admin /opt/homebrew sudo chmod g+rwX /opt/homebrew
- 任一管理员用户执行带路径参数的安装脚本（Apple Silicon 示例）：
curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | sudo bash -s -- --prefix=/opt/homebrew
各用户独立配置 shell 环境
Homebrew 二进制和 Cellar 是共享的，但每个用户的 Shell 初始化逻辑必须单独设置，不能共用 ~/.zshrc 文件或硬链接。否则补全、自动更新、brew doctor 行为会互相干扰。
- 每位用户在自己的
~/.zshrc（macOS Catalina 及以后默认）中添加：export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"
- 加载补全脚本（同样写入各自
~/.zshrc）：if command -v brew >/dev/null; then [[ -r "/opt/homebrew/etc/profile.d/bash_completion.sh" ]] && source "/opt/homebrew/etc/profile.d/bash_completion.sh" fi
- 生效配置：
source ~/.zshrc，然后验证：which brew应返回/opt/homebrew/bin/brew
禁止随意 install/upgrade，由指定用户或机制统一维护
多用户共用 ≠ 多用户随意执行 brew install 或 brew upgrade。这会导致数据库状态不一致、formula 版本混杂、甚至 Cellar 权限错乱。
- 推荐做法：指定一名“运维用户”（如
admin-brew）负责所有安装与升级操作 - 其他用户如需新软件，应提需求，由运维用户执行；或使用
sudo -u admin-brew brew install xxx（需提前配置对应 sudoers 规则） - 若必须允许普通用户执行 brew 命令，可在
/etc/sudoers.d/brew中添加（以用户jane为例）：jane ALL = (admin-brew) NOPASSWD: /opt/homebrew/bin/brew *
验证与日常维护要点
完成配置后，建议每位用户分别运行以下命令确认环境正常：
-
brew --prefix→ 应统一输出/opt/homebrew（或/usr/local） -
ls -ld $(brew --prefix)→ 显示组为admin，权限含drwxrwsr-x（注意中间的s表示 setgid 生效） -
brew doctor→ 不报权限类错误，且提示 “Your system is ready to brew.” -
brew update && brew outdated→ 可正常拉取更新、列出过期包（但不要直接upgrade）
