如何解决 Composer 在 Windows 环境下因路径太长导致的安装失败？-composer-PHP中文网

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

冰火之心

发布： 2025-12-09 13:33:10

原创

476人浏览过

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

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

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

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

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

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

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

帮小忙

腾讯QQ浏览器在线工具箱平台

111

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

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

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

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

大家都在看：