Windows系统默认260字符路径限制导致Composer安装失败，首选启用Win32长路径支持（组策略或注册表），辅以缩短项目路径、使用--prefer-dist参数、升级Composer及检查PHP配置。
Windows 系统默认对文件路径长度限制为 260 个字符（MAX_PATH），而 Composer 在安装依赖时会生成深层嵌套的 vendor 目录结构（比如 vendor/package-name/src/Some/Nested/Class.php），很容易突破这个限制，导致安装失败、报错如 failed to open stream: No such file or directory 或直接卡死。
启用 Windows 长路径支持（推荐首选）
这是最根本、一劳永逸的解决方式。从 Windows 10 版本 1607 起，系统已支持长路径，但默认关闭。只需开启即可：
- 按 Win + R，输入
gpedit.msc打开组策略编辑器（家庭版 Windows 无此工具，见下一条） - 依次展开：计算机配置 → 管理模板 → 系统 → 文件系统
- 双击「启用 Win32 长路径」→ 选择「已启用」→ 点击确定
- 重启终端（CMD/PowerShell/Git Bash）或重启电脑生效
若用的是 Windows 家庭版，无法使用 gpedit，可改用注册表方式：
打开注册表编辑器（regedit），定位到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
将 LongPathsEnabled 的 DWORD 值设为 1（不存在则新建）。
缩短项目路径（快速见效）
不改系统设置也能立刻缓解问题，关键是让 Composer 的根目录尽可能靠近磁盘根部：
中文 Word 文档自动化校对工具。当用户需要对中文文本或 Word 文档进行标点符号检查、语法检查、错别字检查时使用此 skill。触发词：语法检查、错别字、标点符号、校对、检查文档。
- 把项目放在例如
D:\p\myapp或C:\a这类极短路径下，而非C:\Users\YourName\Documents\GitHub\my-project\src\... - 避免在 OneDrive、Google Drive 或 Dropbox 同步文件夹内运行 Composer（这些服务本身也会增加路径前缀）
- 确认当前工作目录是项目根（含
composer.json），不要在子目录里执行composer install
使用 Composer 的 --prefer-dist 和优化参数
源码安装（--prefer-source）会下载完整 Git 仓库，包含 .git 目录和大量历史文件，显著拉长路径；而 dist 包是精简归档，结构更扁平：
- 首次安装时加参数：
composer install --prefer-dist - 全局设置默认行为（一劳永逸）：
composer config -g prefer-dist true - 额外可加
--no-dev（跳过开发依赖）或--optimize-autoloader（减少 autoload 层级），间接降低深度
升级 Composer 并检查 PHP 配置
旧版 Composer（如 1.x）对长路径兼容性较差；PHP 自身也有影响：
- 升级到最新稳定版：
composer self-update - 确保 PHP 使用的是线程安全（TS）版本，且
php.ini中未禁用phar扩展（Composer 依赖它解压 dist 包） - 检查
open_basedir是否误设了过短路径，或disable_functions是否禁用了symlink（影响某些包的安装逻辑）
基本上就这些。优先开长路径支持，再配合短路径+dist 安装，99% 的路径超长问题都能解决。不是什么黑科技，但容易忽略系统层这个开关。
