composer config -g repo.packagist 总不生效是因为必须同时满足三个硬性条件：键名严格为单数 repo.packagist、第二参数显式写 composer、URL 须 HTTPS 且末尾带 /，缺一即静默回退至 packagist.org。
换镜像源能解决 90% 的 Composer 更新慢问题，但配错一个字符、漏清缓存、或没删 composer.lock，就等于白配。
为什么 composer config -g repo.packagist 总是不生效
这条命令静默失败的概率极高，不是 Composer 不工作，而是三个硬条件缺一不可：
-
repo.packagist是唯一合法键名 —— 写成repos.packagist（多一个 s）或packagist.org都无效 - 第二参数必须显式写
composer—— 漏掉它，Composer 2.x 会直接 fallback 到https://packagist.org - URL 必须是 HTTPS 且末尾带
/——https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致拼出/composerpackages.json，404）
验证是否真写进去了：composer config -g repo.packagist。输出为空、null、或仍是 https://packagist.org，说明根本没生效。
配完镜像后仍卡在 “Resolving dependencies” 或 “Downloading”
这两类卡顿原因完全不同，不能混着治：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 卡在
Resolving dependencies：和镜像无关，是依赖图计算慢 —— 检查是否启用了Xdebug（关掉快 5–10 倍），或项目里有大量dev-master版本约束 - 卡在
Downloading https://codeload.github.com/...：镜像只代理元数据，不托管 ZIP 包 ——composer.lock里还存着旧的 GitHub 地址，必须删掉composer.lock和vendor/，再跑composer install - 日志里出现
https://api.github.com/：说明触发了 GitHub Rate Limit，检查是否有包硬编码 GitHub URL，报错含GithubRateLimitException就是它
哪些操作必须同步做，单做一项没用
换源 ≠ 加速，这三步必须一起执行，缺一不可：
- 执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 立刻运行
composer clear-cache—— 否则 Composer 优先读本地缓存的海外索引，根本不发请求 - 确认项目级
composer.json没覆盖全局配置：用composer config --list和composer config --list --global对比，看实际生效的是哪个
如果项目根目录已有 "repositories": [...] 字段，它会完全屏蔽全局配置；此时应手动编辑 composer.json，追加一条 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，而不是用命令覆盖整个数组。
parallel-downloads 设多少才真起作用
这个参数只对 composer install 有效，对 composer update 几乎无感 —— 因为依赖解析本身是串行的。
- 默认值
3基本等于没开，推荐设为10：composer config -g parallel-downloads 10 - 别盲目设到
20：低配 CI 或企业内网容易触发file_put_contents(): failed to open stream（临时文件竞争） - 它依赖镜像站支持 HTTP/2 多路复用 —— 阿里云、腾讯云、清华镜像都支持，私有源若不支持，设高了也白搭
最后提醒一句：所有这些操作的前提是 composer --version 显示 2.2+；如果是 1.x，先 composer self-update，否则很多参数压根不识别。
