composer如何解决 “failed to create symbolic link” 符号链接创建失败（尤其在Windows）

优先以管理员身份运行命令行并启用开发者模式解决Windows下Composer符号链接创建失败问题，若无效则通过配置禁用符号链接或检查安全策略限制。

在使用 Composer 安装或更新 PHP 包时，Windows 用户常遇到 "failed to create symbolic link" 错误。这通常发生在开发环境尝试创建符号链接（symlink）时，系统权限或配置不支持该操作。下面介绍几种有效解决方案。

1. 以管理员身份运行命令行

Windows 默认限制普通用户创建符号链接。即使你是管理员账户，也需显式以管理员权限运行终端。

• 右键点击“命令提示符”或“PowerShell”
• 选择“以管理员身份运行”
• 再次执行 composer install 或 composer update

2. 启用开发者模式（适用于 Windows 10/11）

启用开发者模式后，非管理员用户也可创建符号链接，避免频繁提权。

• 打开“设置” → “隐私和安全性” → “开发者选项”
• 启用“开发人员模式”

启用后，Composer 在大多数情况下可正常创建符号链接。

3. 修改 Composer 配置禁用符号链接

若无法解决权限问题，可强制 Composer 使用复制方式代替符号链接。

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

27

查看详情

• 全局关闭：composer config -g --disable-tls true
• 项目级关闭：进入项目目录，运行 composer config --no-plugins allow-synlinks false

注意：实际参数应为 discard-changes 或通过平台配置控制。更直接的方法是设置环境变量：

set COMPOSER_DISABLE_XDEBUG_WARN=1
set COMPOSER_ALLOW_SYMLINKS=0

或将 COMPOSER_ALLOW_SYMLINKS=0 添加到系统环境变量中。

4. 检查杀毒软件或安全策略

某些安全软件会阻止符号链接创建，尤其是企业环境中组策略限制。

• Windows Defender 是否启用了攻击面减少规则（ASR）
• 组策略中是否禁用“创建符号链接”权限
• 临时关闭第三方杀毒软件测试是否解决问题

基本上就这些常见原因和应对方式。优先尝试管理员运行 + 开发者模式，若仍不行则关闭符号链接功能。虽然性能略降（文件被复制而非链接），但开发体验不受影响。

以上就是composer如何解决 “failed to create symbolic link” 符号链接创建失败（尤其在Windows）的详细内容，更多请关注php中文网其它相关文章！