Windows默认260字符路径限制导致Composer安装失败，首选启用Win10长路径支持（gpedit.msc配置），其次设置COMPOSER_HOME到短路径、使用--no-scripts/--no-plugins参数或缩短项目路径。
Windows 系统默认对文件路径长度限制为 260 字符（MAX_PATH），而 Composer 安装依赖时会生成深层嵌套的 vendor 目录结构，容易触发该限制，导致解压失败、文件写入错误或“Path too long”报错。根本解法是绕过或放宽系统级路径限制。
从 Windows 10 版本 1607 起，系统支持启用长路径（>260 字符），但默认关闭。需手动开启：
gpedit.msc 打开组策略编辑器（家庭版用户需先升级或改用注册表方式）启用后，PHP 和 Composer 就能正常处理超过 260 字符的路径，无需修改项目结构。
Composer 自身缓存（如 vendor 包下载、全局 bin、config.json）若落在深路径下也会加剧问题。可将其挪到根目录级短路径：
C:\comphome
setx COMPOSER_HOME "C:\comphome"（永久设置环境变量）composer config --global home 确认已生效这能显著减少全局操作中的路径深度，尤其对 composer global require 类命令很有效。
某些包的安装脚本（如 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中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
广告
收藏
收藏
收藏
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
911
