Composer镜像未生效是因为repo.packagist键名、composer type值、HTTPS且末尾带/的URL三者任一缺失即静默回退官方源；验证必须通过composer config -g repo.packagist输出完整JSON及composer install -vvv日志中出现镜像域名确认。
缓存清了还慢，大概率是镜像根本没走成——不是下载慢，是压根没发请求过去。
composer config -g repo.packagist 输出为空或仍是 packagist.org
这说明全局镜像配置压根没写进去，所有后续操作都建立在错误前提上。Composer 2.x 对键名、type 值、URL 格式三者要求极严，错一个字符就静默忽略。
-
repo.packagist必须是单数，写成repos.packagist（多一个 s）或packagist.org都无效 - 命令中必须显式传入
composer作为 type 值：漏掉它，Composer 就当没这回事，直接 fallback 到官方源 - URL 必须是 HTTPS 且以
/结尾：https://mirrors.aliyun.com/composer/✅，少斜杠会拼成/composerpackages.json，返回 404 - 正确命令只有一条：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
composer install -vvv 日志里没出现 mirrors.aliyun.com
配置写了 ≠ 请求走了。日志才是唯一证据，-vvv 不是可选项，是必加项。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer install -vvv 2>&1 | grep "Downloading"，必须看到类似Downloading https://mirrors.aliyun.com/composer/dist/monolog/monolog/...的输出 - 如果日志里还是
packagist.org或已停用的旧地址（如packagist.phpcomposer.com），说明配置被覆盖或未生效 - 项目级
repositories字段优先级高于全局，检查composer.json顶层是否有"repositories": [...]；若有，且里面没写"packagist.org": false，那你的镜像只是“额外源”，官方源仍会先尝试
清完缓存、删了 vendor 和 lock，重装后仍卡在 Resolving dependencies
镜像只加速下载环节（Downloading、Fetching package），不解决依赖解析阶段的卡顿。这个阶段完全在本地 CPU 上跑，和网络无关。
- 检查是否启用了 Xdebug：
php -d xdebug.mode=off $(which composer) install临时禁用，能快 5–10 倍 - 确认
COMPOSER_MEMORY_LIMIT是否足够：默认 128M 在复杂依赖图下常不够，设为-1临时放开限制 - 检查
platform配置是否与当前 PHP 版本匹配，比如"php": "7.4"却在 PHP 8.2 上运行，会触发大量降级查找逻辑 - 某些私有包硬编码了 GitHub URL（如
"dist": {"url": "https://github.com/..."}），这类请求绕不开镜像，需配github-oauth.github.comToken 或改用 Gitee zip 地址
并发下载参数设了但没效果
Composer 2.2+ 已弃用 parallel-downloads，改用 http-max-concurrent-downloads。设错参数名不会报错，也不会生效——这是最常踩的坑。
- 查当前值：
composer config -g http-max-concurrent-downloads - 设新值（推荐 8–10）：
composer config -g http-max-concurrent-downloads 10 - 该参数只对
composer install有效，composer update仍需串行计算依赖图 - 设太高（如 20）容易触发本地 DNS 解析竞争或镜像限流，反而更慢；企业内网或某些 macOS 环境下，建议从 6 开始试
真正关键的点不在“怎么配”，而在“怎么确认它真在跑”。每次改完配置，必须跑一次 composer config -g repo.packagist 和 composer install -vvv | grep Downloading —— 中间任何一环没对上，后面所有优化都是空谈。
