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 类命令很有效。

GemDesign

AI高保真原型设计工具

652 查看详情

使用 --no-scripts 和 --no-plugins 临时规避

某些包的安装脚本（如 post-install-cmd）或插件会在 vendor 内创建额外嵌套，进一步拉长路径。若只是想快速拉下依赖跑起来，可跳过这些阶段：

• 运行 composer install --no-scripts --no-plugins
• 后续再单独执行必要脚本（如 php artisan optimize）
• 注意：仅适用于开发调试，生产环境仍建议修复路径根源

更换安装位置或缩短项目路径

最直接但略显“土”的办法：把项目放在极短路径下，比如 C:\p\myapp 或 D:\a：

• 避免中文、空格、特殊符号命名的父目录
• 不要嵌套在“文档”“下载”等系统默认长路径下（如 C:\Users\XXX\Documents\...）
• 用 cd /d C:\p 快速切换，再 git clone 或 composer create-project

基本上就这些。优先开长路径支持，再配合短路径存放项目，95% 的“path too long”问题都能解决。不复杂但容易忽略。

以上就是如何解决 Composer 在 Windows 环境下因路径太长导致的安装失败？的详细内容，更多请关注php中文网其它相关文章！

相关文章： 韩剧圈正版入口页面_韩剧圈官网登录链接  J*aScript对象创建方式_J*aScript设计模式应用  PHP面向对象编程中避免重复创建PDO数据库连接的最佳实践  钉钉视频会议声音异常如何处理 钉钉会议音频修复技巧  Go语言中高效处理x-www-form-urlencoded表单数据  Lar*el 8 多关键词数据库搜索优化实践  Go与Ruby之间实现AES加密互通：CFB模式下的密钥长度匹配策略  MongoDB Aggregation：在嵌套对象数组中精确匹配ObjectId  Selenium Python中处理点击后新窗口加载冻结问题的策略与实践  必由学官方登录入口 必由学教师学生账号快速访问  c++中的std::basic_string的SSO优化_c++短字符串优化深度解析  Discord Slash 命令响应超时问题的异步解决方案  微信语音通话掉线如何解决 微信语音通话稳定优化方法  “在文档元素之后找到了标记”是什么错误？ 检查并修复XML中多个根元素的3个方法  QQ邮箱电脑版登录入口_QQ邮箱官方网站登录平台  火狐浏览器占用内存高卡顿怎么办 火狐浏览器性能优化设置技巧  C++ explicit关键字防止隐式转换_C++构造函数安全规范  CSS子选择器：如何区分并样式化嵌套列表的子层级  如何在低配置电脑上搭建轻量级J*a环境_占用更小的环境选择技巧  C++如何比较两个字符串_C++ string compare函数与操作符对比  Basecamp怎样用留言钉固定重点_Basecamp用留言钉固定重点【重点标记】  Lar*el Migration：重命名列后添加新列的正确操作顺序  荒野行动PC版怎么注册_荒野行动PC版账号注册详细流程图文教程  Python async/await 协程：CPU密集型任务的陷阱与解决方案  Pyrogram与g4f集成：异步编程实践与常见错误解决  在Go Martini框架中高效服务动态生成图像的实践指南  解决 Express.js 中 PUT 请求密码修改失败的路由配置指南  美团外卖商家服务中心入口 美团商家版官网入口  excel怎么制作工资条 excel快速生成工资条的方法  steam官方入口大全 steam账号注册及操作指南  ACG动漫手机版官网入口 手机ACG动漫APP在线观看正版  Win11怎么开启卓越性能模式 Win11电源选项启用高性能释放硬件潜力【方法】  PHP实现即时文章发布与单次数据库写入：自提交模式教程  192.168.1.1管理中心入口 192.168.1.1路由器网页设置平台  Python自定义类排序：解决lambda键值访问TypeError的实践指南  如何在 Windows 11 中启动游戏手柄设置  html网页设计源代码怎么运行_运行html网页设计源代码步骤【指南】  MAC怎么在地图App里使用“四处看看”_MAC体验部分城市的3D实景街景  AO3网页版最新入口合集 Archive of Our Own在线访问指南  mysql通配符支持数字匹配吗_mysql通配符能否用于数字匹配的解析  Animex动漫社网入口地址 Animex动漫社网正版在线入口  微信网页版扫码登录入口 微信网页版二维码登录入口  微信群消息显示延迟如何解决 微信群消息刷新优化方法  照顾宝贝2小游戏免费秒玩入口  PHP基于会话的用户类型页面访问控制指南  拷贝漫画电脑版官网入口 拷贝漫画(PC版)在线直达  J*a最大堆Heapify方法修复：索引计算与边界条件深度解析  Windows7怎么硬盘安装 Windows7提取ISO镜像到非系统盘并运行setup.exe实现硬盘直装【教程】  天眼查企业查询官网入口 天眼查官方网页版查询  Composer如何在生产环境安全地执行composer update