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 类命令很有效。
使用 –no-scripts 和 –no-plugins 临时规避
某些包的安装脚本（如 post-install-cmd）或插件会在 vendor 内创建额外嵌套，进一步拉长路径。若只是想快速拉下依赖跑起来，可跳过这些阶段：
- 运行
composer install --no-scripts --no-plugins - 后续再单独执行必要脚本（如
php artisan optimize） - 注意：仅适用于开发调试，生产环境仍建议修复路径根源
更换安装位置或缩短项目路径
最直接但略显“土”的办法：把项目放在极短路径下，比如 C:pmyapp 或 D:a：
- 避免中文、空格、特殊符号命名的父目录
- 不要嵌套在“文档”“下载”等系统默认长路径下（如
C:UsersXXXDocuments...） - 用
cd /d C:p快速切换，再git clone或composer create-project
基本上就这些。优先开长路径支持，再配合短路径存放项目，95% 的“path too long”问题都能解决。不复杂但容易忽略。
以上就是如何解决 Composer 在 Windows 环境下因路径太长导致的安装失败？的详细内容，更多请关注php中文网其它相关文章！