composer卡顿主因是配置错误、缓存未清、lock残留或项目级repositories覆盖；需确保全局镜像配置键名正确、type明确、url含https及尾部斜杠，并清理缓存与lock文件。
配了中文镜像还卡在 Loading composer repositories 或 Downloading，大概率不是网络问题，而是镜像链路根本没打穿——配置写错、缓存未清、lock 文件残留、项目级配置覆盖，四者任一存在，Composer 就会静默退回到 packagist.org。
composer config -g repo.packagist 命令为什么总不生效
这条命令必须同时满足三个硬条件，缺一即静默失败，且不报错、不提示：
-
repo.packagist必须是单数键名，写成repos.packagist或repositories.packagist全部被忽略 - 中间必须显式传入
composer作为type值，漏掉它就 fallback 到官方源 - URL 必须是 HTTPS 且末尾带
/，例如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或仍显示 https://packagist.org，说明根本没写进去。
项目级 repositories 字段会完全屏蔽全局镜像
只要 composer.json 里存在 repositories 字段（哪怕只是空对象 {} 或空数组 []），全局配置就会被跳过。这是最常被忽略的坑。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 临时验证：在项目根目录运行
composer config --unset repositories，再试composer install -vvv - 长期方案：若需保留私有源，手动在
composer.json的repositories中添加 packagist 条目，并设顶层"packagist.org": false - 更稳妥的做法：改用项目级配置命令
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会自动追加到repositories中，不破坏已有源
换源后仍卡在 Downloading，是因为 lock 文件和缓存没清干净
镜像只代理元数据和 ZIP 包分发，但 composer.lock 里记录的是旧源的 dist.url，缓存里存着 packagist.org 的 packages.json —— Composer 会优先读这些旧数据，甚至根本不发请求到镜像站。
- 必须执行三步清理：
composer clear-cache（注意不是cache-clear，已废弃） - 手动删掉
vendor/和composer.lock - 再跑
composer install --no-cache强制走新源 - 如果之前已改过镜像但没清缓存，还要手动清理元数据缓存目录：
rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer
并发下载和超时参数要配合镜像实际能力调优
新版 Composer（2.2+）只认 http-max-concurrent-downloads，parallel-downloads 已弃用且不报错——设了也白搭。
- 推荐值：8～10；超过 12 在 macOS 或企业内网易触发 cURL 句柄耗尽
- 弱网下 TLS 握手容易超时，需延长单次等待时间：
composer config -g http.timeout 300（不是http-timeout） - IPv6 不稳定时加环境变量：
CURL_IPRESOLVE=4 composer install - 验证是否真走镜像：运行
composer install -vvv，盯住第一行日志，必须出现类似Downloading https://mirrors.aliyun.com/composer/packages.json
真正卡顿的根源往往不在“网络慢”，而在配置没落地、缓存没清透、lock 文件没刷新、或项目级配置意外覆盖——这些地方错一个字符，Composer 就安静地退回境外源，连个提示都没有。
