Composer config -g repo.packagist 静默失效是因为键名必须为 repo.packagist（非 repos.packagist）、type 值 composer 不可省略、URL 必须 HTTPS 且末尾带 /，三者缺一即回退官方源，验证需输出完整 JSON 或匹配镜像域名的 URL。
换镜像源是解决 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：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行：
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 插件——换任何镜像都无效。
