composer配置镜像必须同时满足三要素：键名repo.packagist（单数）、composer为type值、url为https且末尾带斜杠；否则静默失效仍直连packagist.org；验证需执行composer config -g repo.packagist确认输出正确，并用-vvv日志核实真实请求域名。
composer config -g repo.packagist 命令必须写对三要素
配了镜像但还是走 packagist.org，90% 是这条命令静默失效——不报错、不提示、照样卡住。必须同时满足：
• 键名是 repo.packagist（单数 repo，写成 repos.packagist 就被完全忽略）
• 中间必须带 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 ❌（少斜杠会拼出 404 路径）
验证是否生效：运行 composer config -g repo.packagist，输出应为完整 URL 字符串或 JSON 对象，空、null 或仍显示 https://packagist.org 都说明没写进去。
项目级配置比全局更可靠，但别用命令覆盖 repositories
CI/CD 流水线、宝塔、Docker 容器里常以非登录用户（如 www 或 runner）运行 Composer，-g 写的配置根本读不到。进项目根目录后执行：composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/（不加 -g），它会自动向 composer.json 的 repositories 数组追加 packagist 条目。
⚠️ 别用这个命令覆盖已有源——它会清空你私有的 Git 源或 Satis 源。
正确做法是手动编辑 composer.json，在 repositories 里追加：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}并确保根节点有 "packagist.org": false，否则仍可能 fallback。
换镜像后 composer install 还卡在 downloading？先看 -vvv 日志
光看命令执行完没报错没用。-vvv 是唯一能确认是否真走镜像的方式：
• 执行 composer require monolog/monolog -vvv
• 观察终端输出的 HTTP 请求地址，重点确认域名是否含 mirrors.aliyun.com 或 mirrors.tuna.tsinghua.edu.cn
• 如果看到 https://packagist.org 或重定向（302 Found），说明镜像没生效或被覆盖
• 若请求地址正确但首字节延迟高，用 curl -o /dev/null -s -w "%{time_starttransfer}\n" https://mirrors.tuna.tsinghua.edu.cn/composer/packages.json 测三次取中位数，超 1.5 秒的镜像别用
composer update 拉不到新版本？不是镜像问题，是元数据缓存没刷新
镜像同步及时，但本地仍“看不到”新包，本质是 Composer 复用缓存的 packages.json（默认 15 分钟不过期）。
• composer clear-cache 清不掉这个元数据缓存
• Composer ≥ 2.5：直接跑 composer update --refresh，它只丢弃 packages.json 和 provider-*.json，从当前镜像重新拉元数据
• Composer ≤ 2.4：手动删缓存子目录，路径类似 ~/.composer/cache/repo/https---mirrors-aliyun-com-composer/
• 删完再跑 composer update vendor/package-name，新版本立刻可识别
注意：composer.lock 里记录的 dist.url 仍是旧地址，首次 install 或 update 后会自动更新为镜像路径
composer config -g repo.packagist 输出对了，-vvv 日志里域名对了，--refresh 或手动删缓存也做了，才真正绕开境外源的物理瓶颈。
