Windows上composer install卡在“Failed to create symbolic link”是因NTFS默认禁用符号链接且Composer不自动降级，应强制启用--prefer-dist复制模式而非链接。
为什么Windows上composer install总卡在“Failed to create symbolic link”
这不是权限设置没开，也不是PHP版本太低，而是Composer默认用symlink()复用vendor包，而NTFS默认禁用开发者模式、WSL2挂载卷或Docker容器根本无法创建符号链接。报错后它不会自动降级，直接退出——哪怕你已经装了一半。
立刻生效的修复：强制走复制模式而非链接
别折腾管理员权限或启用开发者模式，直接让Composer放弃链接、改用解压zip的方式安装：
-
composer install --prefer-dist：对当前项目一次生效，CI/部署脚本里加这一句最稳 -
COMPOSER_PREFER_DIST=1 composer install（Linux/macOS）或set COMPOSER_PREFER_DIST=1 && composer install（Windows CMD）：临时环境变量方式 - 永久写入项目配置：
composer config prefer-dist true，会写进composer.json的config段 - 全局强制所有项目走复制：
composer config -g prefer-dist true，适合长期在WSL2、Docker或锁定Windows环境中工作
小心这些“看似相关”但实际无效的操作
--no-scripts和--no-plugins完全不碰符号链接逻辑，它们只跳过钩子和插件加载；删.git目录也未必有用——除非项目里真有"preferred-install": "source"这种配置，否则--prefer-dist才是直击要害的开关。
真正容易被忽略的是：如果你之前用--prefer-source装过包，缓存里可能已存下git克隆产物，下次即使加--prefer-dist，Composer仍可能因历史残留倾向source模式。此时建议先composer clear-cache再重试。
中文路径+符号链接失败=双重暴击，必须拆开处理
中文路径本身不会触发symlink()失败，但它会让mkdir()、scandir()等底层调用更容易出Invalid argument，叠加符号链接限制后，错误日志会混乱难定位。所以务必分开解决：
- 先用
--prefer-dist绕过链接问题 - 再把项目移到纯英文短路径下（如
D:\p\myapp），避免PathTooLongException和PHP路径解析断裂 - 确认
composer.json里name和autoload.psr-4值不含中文或非法字符，否则dump-autoload阶段还会崩
符号链接不是可选优化，是Composer默认工作流的基础设施；一旦系统不支持，就别试图“让它支持”，而是明确告诉它“换种方式干活”。
