Composer安装时的软链接（Symlink）创建错误修复

先说核心结论：Windows下Composer报软链接创建失败，99%跟你的配置或命令没关系，根子在系统权限——符号链接被默认关掉了。

很多开发者一看到vendor/bin里软链接没生成，第一反应是检查Composer版本、PHP版本、甚至怀疑自己写错了composer.json。其实都不用。问题往往就出在Windows自己身上：普通用户默认没有权限执行mklink。而Composer创建软链接时，底层调用的正是这个命令。

怎么确认是不是这个问题？简单，以管理员身份打开PowerShell，敲一句：mklink /D test-link .。如果系统提示“没有足够权限”，那就锁死了。注意，家庭版Windows没有gpedit.msc，这种情况就别折腾组策略了，直接走开发者模式。而如果是企业环境被组策略锁死，那--no-bin-links才是唯一安全的选择——尽管它也有副作用。

启用开发者模式，最稳的解法

Win10和Win11里，启用开发者模式后，系统会自动给当前用户开符号链接的权限。不需要每次提权、不用改组策略、也不会污染文件所有权。

操作很简单：打开「设置 → 系统 → 开发者选项」，开启「开发者模式」。等组件安装完成（可能得重启），然后重启终端——注意，VS Code内置终端、Git Bash、WSL都可以，但不用管理员身份。接着清空vendor/和composer.lock，再跑一遍composer install。如果启用后仍然报错，大概率是缓存残留，务必清干净再试。

Path仓库不生成软链接？检查这三个条件

你在composer.json里配了type: path，结果vendor/my-vendor/pkg变成了复制目录，不是软链接——别误会，这也不是Composer抽风，是它悄悄fallback了。

需要确认三点：

• symlinks: true必须写在repositories里对应path仓库的对象内，不能放在根config下
• 路径必须是相对路径（如../my-pkg）或绝对路径（如C:/dev/my-pkg），含~或$HOME会直接失效
• 目标目录（url指向的路径）必须存在，且里面的composer.json有合法name字段，并且与require中的包名完全一致

如果已经安装了但没有链接，删掉vendor/my-vendor/pkg，加上--prefer-source重装：composer update my-vendor/pkg --prefer-source。

别用管理员CMD“绕过”错误

这个坑太常见了。用管理员身份运行Composer，表面上能过，但实际上生成的软链接归Administrator所有，普通用户后续无法删除、修改vendor/，连composer update都可能卡住。

Windows下所有vendor/目录操作，应该始终以当前登录用户身份执行。如果不慎用管理员跑了一遍导致权限混乱，手动修复比重装更可靠：icacls vendor /reset /T就能把权限重置回来。

对于CI或企业锁定环境，也别硬扛：老老实实加--no-bin-links，同时在composer.json的config里显式设bin-dir: bin/，这样团队成员不会误踩。（顺带提醒一句：很多团队因为没人设置bin-dir，导致vendor/bin目录结构混乱，反倒让软链接问题更难排查。）

真正容易被忽略的点

软链接是否生效，和Composer版本、PHP版本几乎无关。它只取决于Windows是否允许当前用户调用mklink，以及path仓库的路径和命名是否严格匹配。所有其他“技巧”要么在绕开这个前提，要么只是临时安抚报错——而不是真正解决问题。