根本原因是Windows默认路径长度限制为260字符，而Composer依赖嵌套过深易超限；需先启用Win32长路径支持（gpedit或注册表设LongPathsEnabled=1并重启），再配合短路径存放项目、压缩vendor层级及规范路径命名。
根本原因不是 Composer 本身有问题，而是 Windows 默认限制路径长度不超过 260 字符（MAX_PATH），而 Composer 下载的依赖（尤其是嵌套深的 Symfony、Doctrine 等包）解压后极易突破该限制。解决的关键是「系统级放开限制 + 路径层级压缩」双管齐下。
启用 Windows Win32 长路径支持（必须第一步）
这是所有方案的前提——不开启，其他操作只是临时绕路，且部分 Git 操作（如 composer install --prefer-source）仍会失败。
- 按
Win + R输入gpedit.msc→ 计算机配置 → 管理模板 → 系统 → 文件系统 → 启用「启用 Win32 长路径」 - 家庭版无
gpedit？改注册表：regedit打开HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem，将LongPathsEnabled的DWORD值设为1 - 重启终端（CMD/PowerShell/Git Bash）或整个系统才生效；仅关闭再打开窗口不够，旧进程 PATH 和策略缓存未刷新
把项目放在极短路径下（见效最快）
即使开了长路径，深层嵌套 + 用户目录默认长前缀（如 C:\Users\YourName\Documents\GitHub\...）仍可能触发某些 PHP 扩展或旧版工具链的隐式限制。
- 直接建在盘符根目录：例如
D:\p\myapp或C:\a，而非C:\Users\...\project - 避免中文、空格、括号等字符的父目录名（OneDrive/Google Drive 同步文件夹自带长前缀，也请绕开）
- 执行前确认当前工作目录是含
composer.json的项目根目录，别误入子目录运行composer install
配置 Composer 缓存与 vendor 目录路径（一劳永逸）
全局缓存（COMPOSER_HOME）、包下载缓存（cache-dir）、甚至 vendor 本身，都可迁移到短路径，从源头减少深度。
- 设置全局缓存到短路径：
composer config --global cache-dir "C:/c"
- 迁移 Composer 自身配置目录（避免
%USERPROFILE%\AppData\Roaming\Composer过长）：setx COMPOSER_HOME "C:\comphome"
（需重启终端） - 让
vendor落在项目外短路径（推荐）：composer config vendor-dir "C:/v"
，然后运行composer install，依赖将安装到C:\v而非项目内
慎用符号链接和 WSL（适用场景明确）
符号链接（mklink）能“伪装”路径，但需管理员权限，且部分 IDE 或 Git 客户端识别异常；WSL 则彻底脱离 Windows 路径体系，适合长期 PHP 开发者。
- 若必须保留长路径源项目，可用：
mklink /J C:\v D:\very\long\path\to\project\vendor
，再在composer.json中设"config": { "vendor-dir": "C:/v" } - WSL 方案要真正生效，PHP、Composer、Web 服务（Nginx/Apache）都得装在 WSL 内，
/home/user/project下运行，Windows 文件系统（/mnt/c/...）仍受路径限制 - 别混用：不要在 WSL 里挂载 Windows 盘下的项目再跑 Composer —— 那还是走 Windows 文件系统，长路径问题照旧
最容易被忽略的是：开了长路径后没重启终端，或以为改了 composer.json 就立刻生效，其实 vendor-dir 变更必须先删掉现有 vendor 再 composer install；还有人把 COMPOSER_CACHE_DIR 设成带空格的路径（如 C:\Program Files\cache），导致 Composer 启动失败——所有路径务必无空格、无中文、用正斜杠或双反斜杠。
