根本原因是windows默认禁用符号链接权限，需启用开发者模式或配置组策略；推荐启用开发者模式，重启后即可正常创建vendor/bin软链接，其他方法均为临时妥协。
Windows 下 Composer 安装依赖时提示 Symlink creation failed，根本原因是默认不启用开发者模式且 NTFS 符号链接权限被禁用——不是 Composer 本身的问题，而是系统级限制。
确认当前 Windows 是否允许创建符号链接
Composer 在 Windows 上尝试用 mklink 创建软链接（例如 vendor/bin 中的可执行文件），但普通用户账户默认无权执行该操作。需手动验证权限：
- 以管理员身份打开 PowerShell 或 CMD，运行：
mklink /D test-link .
若提示“你没有足够的权限执行此操作”，说明符号链接被禁用 - 检查当前组策略：运行
gpedit.msc→ 计算机配置 → Windows 设置 → 安全设置 → 本地策略 → 用户权限分配 → “创建符号链接”，确认你的用户或组是否在列表中 - 家庭版 Windows 没有
gpedit.msc？只能通过启用“开发者模式”间接获得权限（见下一条）
启用开发者模式（推荐，适用于 Win10/Win11）
这是最简单、兼容性最好的方案，启用后系统会自动赋予当前用户创建符号链接的权限，无需改组策略或提权运行 Composer：
- 打开「设置」→「更新和安全」→「针对开发人员」（Win10）或「系统」→「开发者选项」（Win11）
- 选择「开发者模式」，等待系统安装必要组件（可能需要重启）
- 重启后，
composer install或composer update就能正常创建vendor/bin下的符号链接了 - 注意：启用后首次运行 Composer 可能仍报错，建议清空
vendor/和composer.lock后重试
临时绕过符号链接（不推荐长期使用）
如果无法启用开发者模式（如企业锁死策略），可用 --no-bin-links 跳过创建 vendor/bin 中的符号链接，但会带来副作用：
- 运行：
composer install --no-bin-links
或在composer.json中添加："config": { "bin-dir": "bin/" }（此时 bin 文件会被复制而非链接） - 缺点：全局命令（如
phpunit）无法直接调用；每次composer update都会重新复制二进制文件，占用更多磁盘空间；某些工具（如 Laravel Pint）依赖符号链接行为，可能异常 - 仅适合调试或 CI 环境中临时规避，不要写入团队共享的
composer.json
避免以管理员身份运行终端来“修复”
很多教程建议“用管理员 CMD 运行 Composer”，这看似能绕过权限错误，但实际埋下隐患：
- Composer 生成的符号链接所有权属于 Administrator，普通用户后续无法修改或删除
vendor/ -
composer dump-autoload等命令可能因权限不一致失败 - Git 仓库中混入管理员创建的文件，协作时容易触发权限冲突
- 真正要解决的是“当前用户是否有符号链接权限”，不是“换更高权限执行一次”
开发者模式是 Windows 下 Composer 符号链接问题的根治点，其他方法都是妥协。但要注意：WSL2 环境中不存在此问题——因为符号链接由 Linux 内核处理，与 Windows 权限无关。如果频繁遇到这类限制，值得考虑把 PHP 开发环境迁移到 WSL2。
