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

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

启用 Windows 长路径支持

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

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

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

HKEY_LOCAL_macHINESYSTEMCurrentControlSetControlFilesystem

将 LongPathsEnabled 的值设为 1。

缩短项目路径位置

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

码上飞

码上飞（CodeFlying） 是一款AI自动化开发平台，通过自然语言描述即可自动生成完整应用程序。

430

查看详情

• 例如从：
  C:UsersYourNameDocumentsprojectsclientwebsitebackendmy-project
  改为：
  C:wwwmy-project
• 使用短目录名，避免多层嵌套

调整 Composer 缓存与临时目录

Composer 在安装过程中会解压文件到临时目录，这些路径也可能过长。可通过设置环境变量缩短：

• 设置 COMPOSER_CACHE_DIR 指向短路径，如：
  set COMPOSER_CACHE_DIR=C:c
• 设置 TEMP 或 TMP 环境变量到短路径，例如：
  set TEMP=C:tmp

建议将这些变量添加到系统环境变量中，长期生效。

使用符号链接（Symbolic Links）

若项目必须放在深层路径，可将 vendor 目录挂载到短路径：

• 先移动 vendor 到短路径，如 C:vproject-vendor
• 删除原 vendor 文件夹，执行命令：
  mklink /J vendor C:vproject-vendor

这样 Composer 仍认为 vendor 在项目内，实际存储在短路径下。

基本上就这些。优先启用系统长路径并简化项目位置，多数情况下即可解决。

以上就是如何解决 composer 在 Windows 系统中路径过长的问题？的详细内容，更多请关注php中文网其它相关文章！