卡在Downloading https://时应调http.timeout，该参数控制DNS解析、TLS握手、首字节等待及整个body传输的总耗时，默认300秒，弱网下易触发，需同步检查PHP default_socket_timeout是否足够。
Composer 网络超时不是改一个参数就能解决的问题，必须区分 HTTP 下载卡住还是子进程执行卡死——调错参数只会白等。
卡在 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 -i | grep default_socket_timeout查出的 PHP CLI 底层值若低于你设的http.timeout，会提前掐断连接——常见值是 60，务必同步调高
报 The process timed out 或卡在 Executing command 怎么办？
这是子进程执行太久被杀，比如 git clone、unzip、跑 post-install-cmd 脚本。错误里一定含 [RuntimeException] The process "" exceeded the timeout，加 -vvv 可看到最后那条命令。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
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） - 环境变量没传给子 shell：Windows 用
set COMPOSER_HTTP_TIMEOUT=30 && composer install，Linux/macOS 必须用COMPOSER_HTTP_TIMEOUT=30 composer install（不能写成export后再跑，某些 CI 环境会丢） - 配置被覆盖：运行
composer config --list看实际生效的是哪一层，项目级 config 会覆盖全局 config - 用了
--prefer-dist却硬编码了repositories字段，导致镜像不生效，仍直连慢速源
比调 timeout 更有效的做法是什么？
单纯加 timeout 只是“等得更久”，不能解决根本的网络不稳定问题。真正见效快的操作是：
- 换国内镜像源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 禁用 packagist.org 回源：加
"packagist.org": false到composer.json的repositories里，避免 fallback 到境外源 - 清理缓存：
composer clear-cache，损坏缓存可能引发假性超时 - 排查 WSL2 / Docker / NTFS 挂载卷下的 symlink 解析慢问题，这类卡顿常发生在
Generating autoload files阶段，和网络无关
最容易被忽略的是：http.timeout 和 process-timeout 是两套独立机制，作用阶段不同、互不替代。只改一个基本没用，且必须同步检查 PHP 底层的 default_socket_timeout 是否构成瓶颈。
