卡在Downloading https://应调http.timeout，卡在Executing command或报The process timed out则调process-timeout；二者作用阶段不同、互不替代，需同步配置且须兼顾PHP底层default_socket_timeout。
报错超时不是“网络慢”三个字能糊弄过去的，得先看卡在哪一层：Downloading https://？该调 http.timeout；报 The process timed out 或停在 Executing command？该调 process-timeout。两个参数互不替代，只改一个基本没用。
卡在 Downloading https:// 时怎么调
这是 HTTP 请求阶段卡住，比如拉 packages.json、下载 ZIP 包，错误里常带 cURL error 28 或反复 retry 后失败。它不看 process-timeout，只认 http.timeout（Composer 2.x）或旧版的 http-basic-timeout（v1 兼容项，v2 已忽略）。
-
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 CLI 的
default_socket_timeout（查法：php -i | grep default_socket_timeout）若低于你设的http.timeout，会提前掐断连接——常见值是 60，务必同步调高
报 The process timed out 或卡在 Executing command 怎么调
这是子进程执行太久被杀，比如 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 仓库彻底不可达，会无限挂起
为什么设了还是卡？常见干扰点
调参前先确认是否真走到超时逻辑。很多“卡住”根本不是 timeout 触发的，而是底层连不上：
- 卡在
Resolving dependencies：大概率是 DNS 解析失败或packagist.org域名无法访问，跟 timeout 无关；试dig packagist.org或换 DNS（如114.114.114.114） - 手动
curl -v https://mirrors.aliyun.com/composer/packages.json也卡在* Connected to ...后无响应？说明是 TLS 握手或代理问题，不是 Composer 配置问题 - 公司内网/代理环境必须同时设
HTTP_PROXY和HTTPS_PROXY，只设前者，Composer 默认走 HTTPS 就会直连失败 - 开了 Charles/Fiddler 等抓包工具？关掉——它们会劫持 SSL 连接，导致静默卡死
- WSL2 或 Docker for Mac 下卡在
Generating autoload files？那是文件系统或 PHP 配置问题，不是网络超时
真正麻烦的是：超时参数本身没问题，但你没意识到 http.timeout 只管“连接建立后”的传输，而 DNS 解析慢、TLS 握手卡顿这些前置动作，它根本不计时——这时候光调参数没用，得查代理、换 DNS、甚至临时直连 IP。
