最常用且持久的方式是在 composer.json 的 config 节点下设置 "process-timeout": 900，该值整数无引号、随项目提交、CI/CD 自动继承；全局配置用 composer config -g process-timeout 1200 写入用户级配置文件。
composer.json 里 config.process-timeout 是最常用且持久的方式
直接在项目根目录的 composer.json 的 config 节点下写入 "process-timeout": 900，就能让所有后续 composer install 和 composer update 命令默认用 15 分钟超时。这个值会随项目一起提交，CI/CD 环境自动继承，不需要每次重设。
注意几个易错点：
-
process-timeout是唯一被广泛支持的超时配置项；timeout、http-timeout这类字段名是无效的，Composer 会静默忽略 - 值必须是整数，不能加引号：
"process-timeout": 900✅，"process-timeout": "900"❌ - 改完记得运行
composer dump-autoload -o（虽然不直接影响 timeout，但避免因 autoload 错误掩盖真实超时问题）
全局配置 composer config -g process-timeout 适合统一管理多个项目
运行 composer config -g process-timeout 1200 会把值写进 ~/.composer/config.json，对当前用户所有项目生效。比改每个项目的 composer.json 更省事，尤其适合本地开发环境或 CI runner 镜像预置。
验证是否写入成功，就执行：
composer config -g process-timeout
如果输出 1200，说明已生效；无输出则仍用默认 300 秒。
常见陷阱：
- 别和
composer config process-timeout（不带-g）混淆：后者改的是当前项目composer.json，不是全局 - 全局配置文件路径可能因 Composer 版本或系统不同而变化，比如新版用
~/.config/composer/config.json，建议先composer config -g --list确认实际路径 - 某些旧版 Composer（config.json 中的
process-timeout，优先级低于命令行参数
COMPOSER_PROCESS_TIMEOUT 环境变量优先级最高，但容易被覆盖
设置 COMPOSER_PROCESS_TIMEOUT=0 或 export COMPOSER_PROCESS_TIMEOUT=900，效果等同于命令行加 --timeout=900，而且对所有子命令都生效，包括 composer run-script。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
但它不是“写进配置文件”的方式，而是运行时注入——适合临时调试或 CI 脚本中显式声明：
COMPOSER_PROCESS_TIMEOUT=900 composer install
不过要注意：
- 它会被更外层的系统级限制截断，比如 Docker 的
--stop-timeout、GitHub Actions 的timeout-minutes、或 shell 的timeout 600 composer install - 设为
0表示禁用超时，但一旦遇到网络卡死或镜像不可用，进程会无限挂起，不推荐长期使用 - PHP CLI 模式下若
max_execution_time被disable_functions禁用，该环境变量依然有效，因为它控制的是 Composer 主进程，不是 PHP 脚本执行时间
别把 http.timeout 和脚本超时混为一谈
http.timeout（对应 composer config -g http.timeout）只影响 HTTP 请求阶段（如下载 packages.json 或 zip 包），不控制 git clone、解压、脚本执行这些环节。而 process-timeout 是总闸，覆盖整个命令生命周期。
如果你的命令卡在 Executing command (CWD: /path): git clone，调高 http.timeout 完全没用，必须调 process-timeout 或检查 Git 配置、SSH 代理、私有仓库权限。
另外，自定义脚本（如 post-install-cmd）的执行超时由 PHP 的 max_execution_time 控制，和 Composer 的任何 timeout 配置无关——那是另一个维度的问题，得用 php -d max_execution_time=0 composer install 或脚本内 set_time_limit() 解决。
真正难的不是写哪一行配置，而是搞清哪一层在超时、谁在读这个值、以及有没有更外层机制把它掐断了。
