如何解决 Composer 在 Windows 环境下因路径太长导致的安装失败？

Windows默认260字符路径限制导致Composer安装失败，首选启用Win10长路径支持（gpedit.msc配置），其次设置COMPOSER_HOME到短路径、使用--no-scripts/--no-plugins参数或缩短项目路径。

Windows 系统默认对文件路径长度限制为 260 字符（MAX_PATH），而 Composer 安装依赖时会生成深层嵌套的 vendor 目录结构，容易触发该限制，导致解压失败、文件写入错误或“Path too long”报错。根本解法是绕过或放宽系统级路径限制。

启用 Windows 长路径支持（推荐首选）

从 Windows 10 版本 1607 起，系统支持启用长路径（>260 字符），但默认关闭。需手动开启：

• 按 Win + R 输入 gpedit.msc 打开组策略编辑器（家庭版用户需先升级或改用注册表方式）
• 依次展开：计算机配置 → 管理模板 → 系统 → 文件系统
• 双击“启用 Win32 长路径”，选择“已启用”，点击确定
• 重启终端或重新登录系统生效

启用后，PHP 和 Composer 就能正常处理超过 260 字符的路径，无需修改项目结构。

设置 COMPOSER_HOME 到短路径目录

Composer 自身缓存（如 vendor 包下载、全局 bin、config.json）若落在深路径下也会加剧问题。可将其挪到根目录级短路径：

• 新建一个简短目录，例如 C:\comphome
• 在命令行执行：
  setx COMPOSER_HOME "C:\comphome"（永久设置环境变量）
• 重启终端，运行 composer config --global home 确认已生效

这能显著减少全局操作中的路径深度，尤其对 composer global require 类命令很有效。

标签： composer php js git json windows 计算机 app win10 注册表 环境变量 解压 w