如何解决 composer 在 Windows 系统中路径过长的问题？

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

Windows 系统对文件路径长度默认限制为 260 个字符，当使用 Composer 安装依赖时，嵌套较深的 vendor 目录容易触发“文件名过长”错误。这个问题在 PHP 项目中尤其常见。解决方法主要围绕缩短路径和启用系统长路径支持两方面。

启用 Windows 长路径支持

现代 Windows 10 和 Windows 11 版本支持超过 260 字符的路径，但需要手动开启：

• 按 Win + R 输入 gpedit.msc 打开本地组策略编辑器（家庭版用户需通过注册表）
• 导航到：计算机配置 → 管理模板 → 系统 → 文件系统
• 启用“启用 Win32 长路径”选项

若无法使用组策略，可修改注册表：

将 LongPathsEnabled 的值设为 1。

缩短项目路径位置

将项目移到更靠近磁盘根目录的位置，显著减少总路径长度：

标签： php composer windows 计算机 mac 注册表 环境变量 解压 win 解决方法 windows 11