卡在Downloading https://时应调http.timeout参数，它控制DNS解析、TLS握手、首字节等待及整个body传输总时间，默认300秒，弱网下易超时，需同步调高PHP的default_socket_timeout。
Composer install 超时不是单一参数能解决的问题，必须先判断卡在哪一环：是 DNS 解析失败、HTTP 下载中断、git clone 挂起，还是 autoload 生成卡住。调错参数只会白等。
卡在 Downloading https:// 时该调 http.timeout
这是 HTTP 请求阶段卡住，比如拉 packages.json、下载 ZIP 包，错误里常带 cURL error 28 或反复 retry 后失败。它不看 process-timeout，只认 http.timeout（Composer 2.x）。
-
http.timeout控制 DNS 解析 + TLS 握手 + 首字节等待 + 整个 body 传输的总时间，单位秒，默认仅 300（5 分钟），弱网下极易触发 - 项目级最稳：运行
composer config http.timeout 600，写入当前composer.json的config段，可提交、可复现 - 全局生效：用
composer config -g http.timeout 600，写入~/.composer/config.json - 临时覆盖优先级最高：
COMPOSER_HTTP_TIMEOUT=1200 composer install，适合 CI 调试 - 注意：
php -i | grep default_socket_timeout查出的 PHP CLIdefault_socket_timeout若低于你设的http.timeout，会提前掐断连接——常见值是 60，务必同步调高
卡在 Executing command 或报 The process timed out 该调 process-timeout
这是子进程执行太久被杀，比如 git clone、unzip、跑 post-install-cmd 脚本。错误里一定含 [RuntimeException] The process "" exceeded the timeout，加 -vvv 可看到最后那条命令。
-
process-timeout控制单个外部命令最大执行时间，默认 300 秒，和 HTTP 完全无关 - 全局改：运行
composer config -g process-timeout 1800（30 分钟），写入~/.composer/config.json - 项目级改：直接在
composer.json顶层加"config": {"process-timeout": 1200} - CI 环境建议用环境变量兜底：
COMPOSER_PROCESS_TIMEOUT=2000，某些 Composer 版本对它更敏感 - 设为 0 表示不限时，但不推荐——万一远程 Git 仓库彻底不可达，会无限挂起
换镜像源比调超时更有效，但要注意 fallback 行为
单纯延长超时只是“等得更久”，不能解决根本的网络不稳定问题。国内用户直连 packagist.org 成功率极低，尤其涉及 GitHub API 或私有包时。
- 全局换阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 禁用 packagist.org 回源（防止 fallback 拖慢）：
composer config -g repo.packagist false - 注意：镜像只加速公共包，对
"type": "git"的包（如git@github.com:user/repo.git）无效，这类仍走 git clone，需额外配GIT_SSH_COMMAND或改 HTTPS 克隆 - 切源后必须清缓存：
composer clear-cache；Windows 用户还得手动删%LOCALAPPDATA%\Composer\cache -
composer.lock里硬编码了旧源地址，不清它就会反复重试失败路径
卡在 Generating autoload files 后无响应？这不是网络问题
这阶段不发任何网络请求，本质是文件系统或 PHP 配置问题：递归扫描大量文件（尤其 vendor/ 下有 symlink 或嵌套过深）、WSL2 元数据开销、APCu 未启用 CLI 模式等都可能导致假死。
- 临时跳过：
composer install --no-autoloader，安装完再手动运行composer dump-autoload --optimize - 检查 PHP CLI 的
memory_limit（建议 ≥ 1.5G），update 阶段解析锁文件最吃内存 - WSL2 用户可试关闭 symlinks：
composer install --no-scripts --no-plugins，再单独处理 autoload - 确认 APCu 是否在 CLI 模式启用：
php -m | grep apcu，没输出就需在php.ini中补上apc.enable_cli=1
最容易被忽略的是：HTTP 层和子进程层的超时是两个独立开关，只调一个大概率还会失败；另外，composer.json 里的 config.timeout 在 Composer 2.x 中已不生效，真正起作用的是 http.timeout 和 process-timeout —— 这个区别，90% 的人第一次都会踩坑。
