优先启用Windows长路径支持并将项目移至短路径如C:\www,可解决Composer因路径过长导致的安装失败问题。

Windows 系统对文件路径长度默认限制为 260 个字符,当使用 Composer 安装依赖时,嵌套较深的 vendor 目录容易触发“文件名过长”错误。这个问题在 PHP 项目中尤其常见。解决方法主要围绕缩短路径和启用系统长路径支持两方面。
现代 Windows 10 和 Windows 11 版本支持超过 260 字符的路径,但需要手动开启:
若无法使用组策略,可修改注册表:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem将 LongPathsEnabled 的值设为 1。
将项目移到更靠近磁盘根目录的位置,显著减少总路径长度:
Composer 在安装过程中会解压文件到临时目录,这些路径也可能过长。可通过设置环境变量缩短:
建议将这些变量添加到系统环境变量中,长期生效。
若项目必须放在深层路径,可将 vendor 目录挂载到短路径:
这样 Composer 仍认为 vendor 在项目内,实际存储在短路径下。
基本上就这些。优先启用系统长路径并简化项目位置,多数情况下即可解决。以上就是如何解决 composer 在 Windows 系统中路径过长的问题?的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号