Mac Docker挂载写入失败的根本原因是macOS→Linux VM→容器三层权限链断裂，需依次检查宿主机目录权限与ACL、Docker Desktop File Sharing设置、VM内/host_mnt映射状态、UID/GID映射一致性。
Mac上Docker挂载本地目录后容器内提示“Permission denied”写入失败，根本原因是macOS→Docker Desktop内置Linux VM→容器三层权限链断裂，不是简单chmod就能解决，必须逐层验证宿主机目录权限、File Sharing配置、VM映射状态和UID/GID一致性。
检查宿主机目录的macOS原生权限与ACL
先确认Mac本体是否允许你写入该路径：终端执行 ls -ld /Users/yourname/project，输出中当前用户字段必须含 【rwx】（如 drwxr-xr-x+ 中第三位是 x、第四位是 r，且用户名匹配）。
ACL可能锁死写权限：运行 ls -le /Users/yourname/project，若看到 0: group:everyone deny write 这类条目，必须清除——用 chmod -N /path 删除整个ACL，或用 chmod +a "everyone allow write" /path 显式放行。
特别注意 /private/tmp 和 /var/folders：Docker Desktop默认用它们做中间缓存，若被SIP或误操作设为只读，整个挂载链会中断。执行 ls -ld /private/tmp 验证权限是否为 drwxrwxrwt。
验证Docker Desktop File Sharing设置
打开 Docker Desktop → Preferences → Resources → File Sharing。
确认你的挂载路径（如 /Users/yourname/project）已明确添加到共享列表中；没加进去的路径，Docker VM根本看不到。
刚添加完必须点右下角 【Apply & Restart】——不重启不生效。
避免使用 ~ 或符号链接路径：File Sharing只认绝对路径，且不跟随 symlink。务必在目标目录中执行 pwd 确认真实路径再填入。
测试Linux VM内/host_mnt映射是否通路
第一步：运行调试容器验证基础通路：docker run --rm -it -v /Users/yourname/project:/test alpine ls -l /test
若报 Permission denied 或返回空，说明前两步某处断了；若能列出文件但提示 Operation not permitted，大概率是gRPC-FUSE的UID映射拦截。
第二步：进VM查底层映射（需Docker Desktop 4.15+）：docker run --rm -it --privileged alpine cat /proc/mounts | grep host_mnt
输出中应含类似 /dev/sda1 /host_mnt/Users/yourname/project ... 的行，且挂载选项含 rw。
第三步：确认容器内进程UID与宿主机目录所有者UID一致。若宿主机目录属主是UID 1001，而容器以UID 1000运行，则必须统一——要么在 docker run 中加 --user 1001:1001，要么在Dockerfile中用 USER 1001 声明。
