必须启用Windows长路径支持（LongPathsEnabled=1并重启），否则autoload_static.php中硬编码的绝对路径超260字符会导致PHP include失败；需避开中文用户名、OneDrive等同步目录，项目移至D:\p\myapp等短路径，并禁用Xdebug以避免依赖解析卡顿。
Windows 路径过长报错：必须开 LongPathsEnabled
Composer 在中文用户名（如 C:\Users\张三\Documents\myapp）下生成的 autoload_static.php 会硬编码完整绝对路径，一旦超 260 字符，PHP 的 include 或 file_exists 直接失败，报“系统找不到指定的路径”——这不是 Composer 错，是 Windows 底层限制。
- 改注册表：
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem\LongPathsEnabled设为DWORD值1（不是字符串，不加引号） - 组策略（专业版/企业版）：「计算机配置 → 管理模板 → 系统 → 文件系统」→ 启用「启用 Win32 长路径」
- 改完必须重启整机（不只是终端），否则旧进程不生效
- 验证是否生效：
php -r "var_dump(defined('PHP_WINDOWS_LONG_PATHS'));"返回true才算成功
中文路径 + 同步盘 = 自动加载崩溃
OneDrive / Google Drive / Dropbox 会在真实路径前加一层虚拟挂载前缀（如 C:\Users\张三\OneDrive\Projects\...），实际路径长度翻倍，且实时同步会阻塞 vendor/ 写入，导致 composer install 卡死或静默失败。
- 把项目根目录移到纯本地路径，例如：
D:\p\myapp（比C:\Users\张三\Documents\GitHub\myapp少掉至少 40 字符前缀） - 检查当前路径是否在同步目录内：
dir输出中若含OneDrive、Google Drive字样，立刻迁移 - 避免空格和中文出现在路径任意层级——哪怕只是
src/工具类/这种子目录，某些 PHP 扩展（如 cURL）也会解析失败
Composer install 卡在 Resolving dependencies？先关 Xdebug
中文系统用户常因开发环境默认开启 Xdebug（比如通过 XAMPP/WAMP），导致依赖求解阶段 CPU 持续 95%+，耗时从 30 秒拖到 10 分钟以上。这不是网络问题，是本地 PHP 解析器被钩子严重拖慢。
Windows-Android_SSH_Remote_Control
下载
通过 SSH 隧道从 Android 设备在互联网上对 Windows PC 实现完整远程控制的设置与使用指南，适用于远程桌面访问、安全 RDP 等。
- 临时禁用：
php -d zend_extension= -d xdebug.mode=off composer install - 确认已关：
php -m | findstr xdebug无输出，或php -i | findstr "xdebug.mode"显示off - 别信
--ignore-platform-reqs能绕过——它只会让 Solver 尝试更多非法组合，死得更慢 - opcache.enable_cli=1 在 PHP 8.2+ 中反而拖慢 Composer，建议 CLI 下保持关闭
镜像 + 缓存 + 参数：四行命令压到 30 秒内
开了 LongPaths 和关了 Xdebug 后，下一步是确保所有加速项生效。国内镜像不清理缓存等于白配，参数漏一个就可能多花 2 分钟。
- 全局设阿里云镜像并清缓存：
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/ && composer clear-cache - 缓存目录务必指向 SSD：
composer config -g cache-dir "D:\composer-cache" - 生产部署必用这组参数：
composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative - 开发机慎用
--classmap-authoritative：新增类不会被自动识别，只应在 CI 或打包时用
路径长度、Xdebug、缓存污染，这三个点卡住就全盘慢；调对了，中文 Windows 11 上跑 composer install 和英文系统没差别。
