镜像配置未生效主因是repo.packagist键名错误、漏写type值composer、URL缺末尾/，三者缺一即静默回退官方源；需验证输出完整JSON、清缓存、检查项目级repositories覆盖及更新composer.lock中dist.url。
改了镜像源还慢，大概率是配置根本没生效——Composer 不报错，但会静默 fallback 到 https://packagist.org，你还在等它响应。
repo.packagist 配置写对了吗？三个硬条件缺一不可
Composer 2.x 对键名、type、URL 格式有严格要求，漏掉任意一个，就等于没配：
-
repo.packagist不能写成repos.packagist（多一个s就彻底忽略） - 命令中必须显式传入
composer作为 type 值：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 必须是 HTTPS + 末尾带
/：https://mirrors.aliyun.com/composer/✅，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，说明完全没生效。
缓存没清干净，换源等于白换
Composer 默认复用本地缓存的 packages.json 和 provider-*.json，哪怕你刚切了镜像，它仍按旧元数据算依赖，甚至继续尝试从 https://packagist.org 拉索引——卡在 DNS 或 TLS 握手阶段。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行
composer clear-cache（不是已废弃的composer cache-clear） - 检查
~/.composer/cache/repo/是否为空，或临时加--no-cache跑一次composer install -vvv，看日志里请求的是哪个域名 - Composer ≥ 2.5：可直接用
composer update --refresh，只删元数据缓存，不碰 ZIP 包
项目级 repositories 正在覆盖你的全局配置
只要项目根目录的 composer.json 里有 repositories 字段，全局设置就自动失效。这不是 bug，是 Composer 的设计逻辑。
- 检查方式：
composer config repo.packagist（不加-g），有输出说明项目级配置存在 - 临时禁用：
composer config --unset repositories，只删当前项目的repositories字段 - 若项目必须保留私有源，需显式禁用默认源：
"packagist.org": false，且放在composer.json根节点，不能塞进repositories数组里
dist.url 还在指向 packagist.org
镜像只改元数据获取路径，不自动更新 composer.lock 里每个包的 dist.url。安装时 Composer 仍优先尝试旧地址，失败后不一定 fallback，尤其在 CI 或企业内网容易直接超时。
- 必须执行
composer update --lock，强制重写所有包的dist.url，让它指向镜像源路径（如https://mirrors.aliyun.com/composer/dists/） - 验证是否生效：打开
composer.lock，搜任意包（如monolog/monolog），确认其dist.url值以镜像域名开头 - 新项目建议用
composer create-project --repository=https://mirrors.aliyun.com/composer/，跳过旧 lock 干扰
真正卡住的地方往往不是网络，而是配置没对齐、缓存没刷新、lock 文件没更新这三处。尤其 repo.packagist 键名拼错和 dist.url 滞后，最容易被忽略。
