umask 002 表示屏蔽其他用户写权限，使新建文件为664（rw-rw-r--）、目录为775（rwxrwxr-x），解决Composer因新生成文件组不可写导致的“failed to open stream”错误。
umask 002 是什么，为什么它影响 Composer install
umask 是系统级的“权限掩码”，它决定新创建文件和目录的默认权限。比如 umask 0022 会让新目录变成 drwxr-xr-x（755），新文件变成 -rw-r--r--（644）——组和其他用户都没有写权限。而 Composer 在生成 vendor/autoload.php、写入 composer.lock 或缓存时，常需要组可写（尤其当 Web 服务器用户如 www-data 和 CLI 用户同组时）。若 umask 过严，哪怕目录归属正确，新文件一生成就不可写，报错 failed to open stream: Permission denied 就会复现。
怎么临时设 umask 让 Composer 跑通
不改系统配置，只对当前命令生效，最安全：
- 运行
umask 0002（注意是四位数字，前导零不能省） - 再执行
composer install或composer update - 验证：
ls -l vendor/应看到目录权限类似drwxrwxr-x（775），文件如autoload.php是-rw-rw-r--（664）
这个设置只在当前 shell 会话有效，关掉终端就自动恢复，不会污染系统环境。
怎么永久设 umask 避免每次手动输
永久设置要谨慎，只推荐加到用户级 shell 配置里，且仅限开发机（生产服务器通常由运维统一管理）：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 编辑
~/.bashrc或~/.zshrc（看你的 shell） - 末尾追加一行：
umask 0002 - 执行
source ~/.zshrc（或对应文件）立即生效 - 注意：不要设成
0000（全开）或007（组无读），前者有安全风险，后者会导致 Web 服务读不到文件
如果项目部署在共享主机或 Docker 容器中，umask 应在容器启动脚本或部署流程里显式设置，而不是依赖用户 shell 配置。
umask 不是万能解药，这些坑得一起清
即使 umask 设对了，以下问题仍会导致权限失败：
-
vendor/目录本身属主是root：先跑sudo chown -R $USER:$USER vendor/，否则新 umask 对旧文件无效 - 父目录（如项目根）权限为
drwxr-xr-x且属主不是你：chmod u+w .或chown $USER:$USER . - Web 服务器用户（如
www-data）和 CLI 用户不同组：需用sudo usermod -a -G www-data $USER并确保目录组可写 - Docker 挂载卷 UID 不匹配：容器内必须以和宿主机一致的 UID 运行，例如
docker run -u $(id -u):$(id -g) ...
umask 只管“新文件怎么生”，不管“老文件归谁管”——修复所有权永远是第一步，设 umask 是第二步，漏掉前者，后者白搭。
