macOS Monterey中Homebrew报apply2files权限错误修复方法

报错触发场景 #

执行brew install、brew upgrade、brew cleanup等涉及文件链接操作的Homebrew命令时，抛出如下错误中断执行：

Error: Permission denied @ apply2files - /usr/local/lib/docker/cli-plugins

根因 #

该目录是Docker Desktop安装时自动创建的，默认所有者为root，普通用户身份运行的Homebrew没有该目录的写入/修改权限，在执行软链接创建、旧文件清理步骤时就会触发权限拒绝。

修复操作 #

1. 可先在终端执行命令快速获取当前登录系统的用户名：

whoami

终端输出的字符串就是你的当前用户名。
2. 给报错对应的目录重新分配当前用户的所有权，终端执行：

sudo chown -R $(whoami):admin /usr/local/lib/docker/cli-plugins

执行后按提示输入开机密码，输入过程终端不会显示密码内容，输入完成直接回车确认即可。
3. 如果执行完上述步骤后仍有同类权限报错，可根据自己Mac的芯片类型，修复Homebrew整个安装目录的权限：

• Intel芯片Mac执行：

sudo chown -R $(whoami):admin /usr/local/*

• Apple Silicon（M1/M2/M3系列）芯片Mac执行：

sudo chown -R $(whoami):admin /opt/homebrew/*

4. 权限修复完成后，重新执行之前触发报错的Homebrew命令即可。如果需要补全之前失败的链接操作，可先执行模拟命令校验操作范围：

brew link --overwrite --dry-run

确认输出的待操作文件均为Homebrew管理的软件文件后，去掉--dry-run参数正式执行即可。

注意：不要随意修改/System、/usr/bin等系统核心目录的权限，仅针对报错明确指向的路径、以及Homebrew自身的安装路径调整权限，避免影响系统稳定性。

内容的提问来源于stack exchange，提问作者laitifranz