可通过环境变量COMPOSER_PROCESS_TIMEOUT设置Composer超时时间(默认300秒),支持命令行临时设置、系统级永久设置,但不可通过composer config配置;验证可用composer diagnose -v | grep timeout。

可以通过设置环境变量 COMPOSER_PROCESS_TIMEOUT 来控制 Composer 命令执行的超时时间(单位:秒),默认值为 300 秒(5 分钟)。
在命令行中临时设置
适用于单次运行,不改变系统或用户级配置:
- Linux/macOS:COMPOSER_PROCESS_TIMEOUT=600 composer install(设为 10 分钟)
- Windows(CMD):set COMPOSER_PROCESS_TIMEOUT=600 && composer install
- Windows(PowerShell):$env:COMPOSER_PROCESS_TIMEOUT="600"; composer install
永久设置环境变量
让所有后续 Composer 命令都生效:
- Linux/macOS:将 export COMPOSER_PROCESS_TIMEOUT=600 加入 ~/.bashrc 或 ~/.zshrc,然后运行 source ~/.bashrc
- Windows:在“系统属性 → 高级 → 环境变量”中添加系统或用户变量,名称为 COMPOSER_PROCESS_TIMEOUT,值设为数字(如 600)
通过 Composer 配置文件设置
使用 composer config 命令写入全局或项目级配置(注意:该变量不能通过 config 命令直接设置,因为它是纯环境变量,Composer 不将其视为配置项)
- ✅ 正确做法仍是靠环境变量,composer config 无法替代它
- ⚠️ 不要尝试 composer config --global process-timeout 600 —— 这个选项已废弃且无效
验证是否生效
运行以下命令可查看当前生效的超时值(Composer 会打印调试信息):
- composer diagnose -v | grep timeout
- 或观察安装/更新卡住时,是否在设定秒数后报错 The process timed out










