根本原因是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。