vendor/bin软链接Permission denied主因是vendor/bin目录不可写或目标文件只读，需先chown修复属主并chmod补读权限，而非chmod -R 777；全局bin失败应改用~/.local/bin并加入PATH；WSL/Docker中须避免跨系统挂载导致符号链接失效。
vendor/bin 里的软链接为什么 Permission denied
报错通常长这样：Could not symlink /home/user/project/vendor/bin/phpunit -> /home/user/project/vendor/phpunit/phpunit/phpunit。根本不是 Composer 想提权，而是它试图用 symlink() 函数创建软链接时，目标路径（这里是 vendor/bin/）对当前用户不可写——或者更隐蔽：软链接本身能建，但指向的目标文件（比如 vendor/phpunit/phpunit/phpunit）权限是只读的，导致 PHP 的 readlink() 或后续执行失败。
常见诱因包括：
-
vendor/目录被之前sudo composer install创建，属主是root，普通用户无法在vendor/bin/下新建或覆盖软链接 - 某些包（如
phpunit、phpcs）的bin/文件在vendor/{vendor}/{package}/内被设为只读（比如 Git 检出后保留了 readonly 属性） - Windows + WSL 或 Docker volume 挂载时，底层文件系统不支持符号链接，或 ACL 禁止创建
怎么安全修复 vendor/bin 软链接权限
别直接 chmod -R 777 vendor/——这会破坏可执行位语义，还可能让 CI 拒绝构建。优先归还所有权，并确保 vendor/bin/ 可写：
- 运行
ls -ld vendor/bin，确认第三列是当前用户名；如果不是，执行sudo chown $USER:$USER vendor/bin（只改目录本身，不递归） - 检查软链接目标是否存在且可读：
ls -l vendor/phpunit/phpunit/phpunit；若显示----------或权限含w缺失，用chmod u+r vendor/phpunit/phpunit/phpunit补读权限 - 临时绕过：加
--no-scripts和--no-plugins运行composer install --no-scripts --no-plugins，看是否成功——若成，说明问题出在某个包的post-install-cmd里硬编码了chmod或误删了 bin 文件
全局 bin 目录软链接失败怎么办
错误信息类似：Could not symlink /usr/local/bin/composer -> /home/user/.composer/vendor/composer/composer/bin/composer。这不是项目级问题，而是 Composer 全局 bin 目录没写权限。
- 查当前配置：
composer config --global bin-dir，大概率返回/usr/local/bin - 改到用户空间：
composer config --global bin-dir ~/.local/bin - 确保该路径已加入
$PATH：echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - 之后所有
composer global require生成的软链接都会落在~/.local/bin/下，无需sudo
Docker 或 WSL 中软链接失效的典型表现
在容器内跑 composer install 后，宿主机看到 vendor/bin/phpunit 是个空文件或报 No such file or directory，其实是因为符号链接指向了容器内路径（如 /var/www/vendor/...），而宿主机根本不存在该路径。
- 不要在 bind mount 的 volume 上直接运行
composer install（例如docker run -v $(pwd):/app ... composer install） - 正确做法：Dockerfile 中
COPY composer.json composer.lock .→RUN composer install --no-dev→COPY --from=builder /app/vendor /app/vendor，并用--chown对齐 UID - WSL 用户避免把项目放在
/mnt/c/下；改用~/projects/等原生路径，再确认/etc/wsl.conf含metadata=true
真正棘手的从来不是“怎么建软链接”，而是搞清它在哪一层断裂：是宿主机没权限写目录，是容器 UID 不匹配，还是 Windows ACL 拦住了 symlink 系统调用。先看报错里那个具体路径，再决定该修 chown、该换 bin-dir、还是该重写 Dockerfile。
