应临时执行umask 0002 && composer install，或长期在~/.zshrc中添加umask 0002；若web服务用户与当前用户不同组，则需先确保二者同组并修正vendor目录属组，再配合g+rx权限设置。
umask 导致 vendor/ 里文件不可写怎么办
不是 Composer 故障，是系统默认 umask 把新生成文件权限设得太严（比如 0022 → 目录 755、文件 644），导致 PHP-FPM 或 Web 服务器以不同用户身份运行时读不到 autoload.php 或加载不了类。常见现象是 composer install 成功但页面报 failed to open stream: Permission denied。
临时修复：在运行 composer install 前加一句 umask 0002，让新建目录变成 775、文件变成 664，保证组可写：
umask 0002 && composer install
长期生效建议直接改 shell 配置（如 ~/.zshrc）：
- 加
umask 0002行，避免每次手动输 - 别用
0000——这会让所有文件变成666，有安全风险 - 如果项目部署在 Web 服务器（如 nginx + php-fpm），确认
www-data或_www用户和你同属一个组，否则umask 0002也无效
为什么 vendor/autoload.php 权限总是 644 却报错
报错路径明确指向 vendor/autoload.php，但 ls -l vendor/autoload.php 显示权限是 -rw-r--r--（即 644），说明问题不在文件本身，而在它的父目录或执行上下文。
关键检查点：
-
ls -ld vendor/—— 如果是drwxr-xr-x（755）且 owner 不是你当前用户，PHP 进程根本进不去该目录 -
id -gn和groups—— 确认当前用户所属组是否和 Web 服务用户一致（例如都属于www组） -
php -i | grep user—— 查看 CLI 和 FPM 下 PHP 实际运行的用户是否一致
若发现 Web 服务用户（如 _www）无法进入 vendor/，仅改 autoload.php 权限没用；必须确保 vendor/ 目录及其所有父级对组可执行（x 位）。
Composer install 后部分文件权限异常怎么批量修正
不是所有文件都需要 chmod -R，盲目递归会破坏可执行文件（如 vendor/bin/phpunit）的 x 位。应按用途分类处理：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- PHP 类文件（
*.php）只需644：find vendor/ -name "*.php" -type f -exec chmod 644 {} \; - 目录必须有
x位才能被遍历：find vendor/ -type d -exec chmod 755 {} \; - 可执行脚本（
vendor/bin/*）需保留x位：find vendor/bin/ -type f -exec chmod 755 {} \; - 别碰
composer.lock和vendor/composer/下的 JSON/lock 文件，它们是只读元数据
注意：chmod 只能补权限，不能修复所有权。如果 vendor/ 属主是 root，先 sudo chown -R $USER:$USER vendor/，再跑上面命令。
Docker 或 CI 环境中 umask 不生效怎么查
CI 构建或 Docker 容器里 umask 常被覆盖，导致 composer install 产出的文件权限不一致。验证方式很简单：
在构建步骤里插入：
umask && ls -l vendor/autoload.php
如果输出 umask 是 0022 但 autoload.php 权限仍是 644，说明没问题；如果权限是 600，就是 umask 被更严策略覆盖了（比如容器基础镜像设了 0077）。
解决方法：
- Dockerfile 中加
RUN umask 0002（放在composer install步骤之前） - GitHub Actions 中用
shell: bash -c "umask 0002 && {{0}}" - GitLab CI 中在
before_script加umask 0002 - 永远别依赖
chmod -R替代 umask —— 它无法保证后续composer update新增文件的权限一致性
最易被忽略的是：Docker 容器里 $USER 可能为空或为 root，导致 chown 失效；务必用 id -u 和 id -g 显式指定 UID/GID。
