卡在Downloading时应调http.timeout，它控制DNS解析、TLS握手、首字节等待及整个body传输，默认300秒；The process timed out错误应调process-timeout，它控制git clone等子进程执行时限，默认300秒。
卡在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，务必同步调高
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 版本对它更敏感
国内用户必须换镜像源，不能只靠调超时
单纯延长 http.timeout 和 process-timeout 只是“等得更久”，不能解决根本的网络不稳定问题。很多项目硬编码了 repositories 或用了私有 VCS 包，镜像只加速公共包，对 git@ 或 https://github.com/xxx 类源无效。
- 全局换源（推荐阿里）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 注意：Laravel Mix、某些 Symfony bundle 会读取
composer.json里的repositories字段，优先级高于全局配置，得同步检查并清理冗余项 - 如果项目含私有 GitLab/GitHub 私仓，别把它们也加进镜像配置里——镜像不代理 VCS，反而会导致
Failed to clone https://xxx: could not connect to server
CI 环境要组合设置，不能只信命令行参数
CI 容器重启后配置丢失，光靠 --timeout 不可靠。环境变量能覆盖插件和自定义 installer 启动的子进程，比命令行参数更底层、更稳定。
- 必须配国内镜像：
composer config -g repos.packagist.org.url https://mirrors.aliyun.com/composer/ - 强制用 dist 包而非源码：
--prefer-dist，避免git clone卡住 - 环境变量比命令行参数更可靠：
COMPOSER_PROCESS_TIMEOUT=1200比--timeout=1200更有效 - 记得同时设置
COMPOSER_HOME，防止缓存路径错乱
default_socket_timeout 和镜像兼容性——前者会让所有 HTTP 超时配置失效，后者会让换源变成假动作；CI 中不显式设 COMPOSER_PROCESS_TIMEOUT，就等于没设。 
