Composer中文镜像处理下载超时问题的实用教程-composer-PHP中文网

composer config -g repo.packagist 静默失效是因为键名必须为 repo.packagist（非 repos.packagist）、type 值 composer 不可省略、url 必须 https 且末尾带 /，三者缺一即回退官方源，验证需输出完整 json 或匹配镜像域名的 url。

composer中文镜像处理下载超时问题的实用教程

换镜像源是解决 Composer 下载超时最直接有效的办法，但 90% 的失败不是镜像不行，而是配置根本没生效——静默失效、格式错一个字符就退回 packagist.org。

composer config -g repo.packagist 命令为什么总不生效

这条命令写错任意一处都会静默失败，不报错、不提示、照样卡在 Loading composer repositories 或 Downloading。必须同时满足三个硬性条件：

repo.packagist 是唯一合法键名（repos.packagist、packagist.org、mirror 全部无效）
中间的 composer 是 type 值，不可省略（漏掉它，Composer 2.x 直接 fallback 到官方源）
URL 必须以 https:// 开头且末尾带 /（https://mirrors.aliyun.com/composer ❌ 会拼成 /composerpackages.json 导致 404）

正确命令示例：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。执行后立刻验证：composer config -g repo.packagist 输出应为完整 URL 或 JSON 对象，空、null 或仍含 packagist.org 就说明没写进去。

换源后仍卡在 Downloading 怎么确认真走镜像

光看 config 输出没用，得看到网络请求打到镜像域名才算数。最可靠方式是加详细日志并 grep：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

运行：composer show monolog/monolog -vvv 2>&1 | grep "Downloading"
日志中必须出现 mirrors.aliyun.com、mirrors.tuna.tsinghua.edu.cn 等镜像域名，而不是 packagist.org 或 github.com
若项目根目录 composer.json 中已有 repositories 字段，它会完全覆盖全局配置——此时要检查项目级配置是否写对，而非只盯 ~/.composer/config.json

清缓存和重装 vendor 是绕不开的兜底动作

旧缓存里存着 packagist.org 的元数据，Composer 会优先读缓存并尝试从旧地址校验，结果就是卡在 DNS 或 TLS 握手——不是没走镜像，是根本没发请求过去。

先清缓存：composer clear-cache
删掉 vendor/ 和 composer.lock（别试图保留旧 lock 文件，它记录的是旧源的包哈希，和镜像返回的元数据不兼容，必然报 hash does not match）
强制走新源重装：composer install --no-cache
如果用了私有 Git 仓库或硬编码 GitHub dist.url，这类请求不受镜像影响，需单独处理（如配 github-oauth 或换 Gitee zip 地址）

并发下载和超时参数必须同步调优

Composer 2.2+ 已弃用 parallel-downloads，只认 http-max-concurrent-downloads。设太高反而更卡，尤其在企业内网或某些 macOS 版本上容易触发 SSL 错误。

查当前值：composer config -g http-max-concurrent-downloads
设推荐值：composer config -g http-max-concurrent-downloads 10
必须同步加大超时：composer config -g http.timeout 300 和 composer config -g process-timeout 3600
--prefer-dist 是生产环境必加项，避免 git clone；但它不能跳过 autoload 生成等本地处理阶段

最容易被忽略的是：镜像只加速下载环节（Downloading、Fetching package），不解决 Resolving dependencies 卡顿。如果卡在这里，大概率是 PHP 版本约束太宽、require-dev 包太多，或用了已废弃的 asset 插件——换任何镜像都无效。