根本原因是 symlink 创建失败后 Composer 静默 fallback 到 copy 模式，因 vendor/ 属主为 root 或路径不可写而报 Permission denied；需检查本地包 Git 状态、路径有效性、UID 一致性，并删除 vendor/ 和 composer.lock 后以当前用户重装。
composer install 报 Permission denied 在本地包（path 类型仓库）场景下，**几乎从不因为“目录没写权限”，而是因为 symlink 创建失败后 Composer 自动 fallback 到 copy 模式，又因目标路径不可写而卡在文件复制环节**。修复重点不在 chmod，而在确认 symlink 条件是否满足、路径是否可访问、Git 状态是否合规。
为什么 path 本地包安装时突然报 Permission denied
这不是普通依赖安装失败，而是 path 仓库特有的静默降级问题：Composer 尝试创建符号链接失败后，会自动退回到「复制整个包目录」的模式——此时它要往 vendor/ 下写一堆文件，若 vendor/ 或其父目录属主是 root，就立刻触发 Permission denied。
常见诱因包括：
-
vendor/目录被之前sudo composer install污染过，属主为root - 本地包路径含空格或中文，Windows 下未启用开发者模式，无法创建 symlink
- 本地包目录没执行过
git init && git add . && git commit -m "init"，Composer 拒绝 symlink 并 fallback - 主项目
composer.json里显式写了"config": {"symlinks": false}
检查 symlink 是否真生效了
别信日志，直接看文件系统。运行以下命令确认 vendor/ 下是不是软链：
ls -l vendor/my-vendor/my-package
如果输出里带 ->（如 my-package -> ../../packages/my-package），说明 symlink 成功；如果是一堆普通文件夹结构，就已 fallback 到 copy 模式。
Windows 用户请用：dir vendor\my-vendor\my-package，看到
若不是 symlink，问题一定出在以下任一环节：
- 本地包目录下没有
.git/，或git status显示未跟踪任何文件 - 主项目执行用户 UID 与本地包所在文件系统挂载点 UID 不匹配（常见于 WSL2 或 Docker 挂载）
- 本地包路径用了
~或环境变量，composer.json里url必须是相对路径（如../packages/my-package）或绝对路径（如/home/user/packages/my-package）
修复步骤：先清污染，再重装，不碰 sudo
所有操作必须以当前用户身份执行，sudo 只用于临时修正所有权，绝不用于运行 composer 命令。
- 删掉已错乱的产物：
rm -rf vendor/ composer.lock - 修复项目目录归属：
sudo chown -R $USER:$USER ./（注意结尾的./） - 确保本地包目录有 Git 提交：
cd ../packages/my-package && git init && git add . && git commit -m "init" - 回到主项目，用普通用户重装：
composer install
如果仍 fallback，临时加 -vvv 查看详细日志：composer install -vvv 2>&1 | grep -i symlink，它会明确告诉你为什么拒绝 symlink（比如 “Package is not under source control”）。
CI 或 Docker 环境里 symlink 失败怎么处理
容器内 UID 不一致是最大陷阱。宿主机用户 UID 是 1001，但容器默认以 UID 0（root）启动，挂载进来的本地包目录对 UID 1001 不可写，Composer 就无法创建 symlink。
解决方式不是改权限，而是统一 UID：
- Docker 运行时加参数：
docker run -u $(id -u):$(id -g) ... - CI 脚本中，在
composer install前加修复：sudo chown -R $(id -u):$(id -g) ../packages/my-package - 构建镜像时，提前设置工作区归属：
RUN chown -R www-data:www-data /app/packages（按你实际 Web 用户名调整）
最易被忽略的一点：一旦 symlink 失败并 fallback 到 copy 模式，后续即使修复了 Git 和权限，Composer 也不会自动切回 symlink —— 它已把包内容完整复制进 vendor/，除非你删掉 vendor/ 重新 install。
