Windows系统默认路径长度限制260字符导致Composer安装报错，解决方法包括：启用Win32长路径（组策略或注册表）、配置Composer扁平化autoload、缩短项目基础路径、避免同步文件夹、使用WSL绕过限制。
Windows系统默认对文件路径长度有限制（260字符），而Composer在安装依赖时可能生成深层嵌套的vendor目录结构，导致路径超长报错。解决思路是放宽系统限制或调整Composer行为。
启用Windows长路径支持
这是最根本的解决方式，让系统允许超过260字符的路径：
- 以管理员身份运行组策略编辑器（gpedit.msc）→ 计算机配置 → 管理模板 → 系统 → 文件系统 → 启用“启用Win32长路径”
- 若使用家庭版Windows（无gpedit），可直接修改注册表：HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem，将LongPathsEnabled的DWORD值设为1
- 修改后需重启终端（如CMD/PowerShell）或重启电脑才生效
配置Composer使用扁平化autoload
减少vendor内嵌套层级，间接缩短路径：
- 在项目composer.json中添加：
"config": { "preferred-install": "dist", "sort-packages": true } - 执行composer install --no-dev可跳过开发依赖，降低vendor体积和深度
- 避免安装带大量嵌套子包的大型库（如某些旧版Symfony组件），优先选现代精简版本
更改项目存放位置
从根源缩短基础路径长度：
- 把项目放在盘符根目录下，例如D:\myproject，而非C:\Users\YourName\Documents\GitHub\myproject
- 避免在OneDrive、Google Drive等同步文件夹中运行Composer，它们可能额外增加路径前缀
- 项目名尽量简短，如用api代替user-authentication-api-service
使用Windows Subsystem for Linux（WSL）作为替代环境
绕过Windows路径限制，适合长期PHP开发：
- 安装WSL2并配置Ubuntu等发行版
- 将项目代码放在Linux文件系统（如/home/user/project），再在WSL中运行composer install
- 注意：PHP和Composer需在WSL中单独安装，且Web服务器（如Nginx/Apache）也需在WSL中配置
