直接运行composer config -g repo.packagist，空输出表示走官方源https://packagist.org，正确输出为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}即镜像生效；键名、type值、url末尾斜杠三者缺一不可，否则静默回退至官方源。
怎么确认当前用的是哪个镜像源
直接运行 composer config -g repo.packagist，输出是唯一可靠依据。空结果＝走官方源 https://packagist.org；输出类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}＝镜像已生效。别信 composer config -l 或 composer show -p，前者不显示嵌套字段，后者可能受项目级配置干扰或缓存影响。
为什么镜像配置了但还是慢或失败
三个硬性条件缺一不可：
-
repo.packagist键名不能写成repos.packagist（多一个 s）或packagist.org -
type字段必须显式写为"composer"，不是可选参数 -
url必须以/结尾，例如https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌
任一出错，Composer 2.x 会静默 fallback 到官方源，不报错也不提示。
如何验证镜像站本身是否真正可用
不能只靠 curl -I 看 HTTP 200——首页通不代表元数据接口正常。必须模拟 Composer 实际请求路径：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行
curl -fsSL --max-time 3 https://mirrors.aliyun.com/composer/p2/monolog/monolog.json | jq -e 'has("packages")' - 响应体含
packages字段且退出码为 0，才算通过 - 若超时、返回空 JSON、或
jq报错，说明镜像同步异常或后端故障
注意：部分镜像（如 SJTUG）对出口 IP 有白名单限制，非教育网环境可能直接 403。
项目级配置下如何避免私有仓库被覆盖
别手动编辑 composer.json 的 repositories 数组——极易引号错位、括号不全。正确做法是进项目根目录后执行：
-
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 命令会自动合并：若原
repositories是对象，转为数组并追加；若是数组，则插入末尾 - 切勿写
"packagist.org": false，这会导致基础扩展（如ext-json）校验失败
改完立刻跑 composer update --lock，确保 composer.lock 记录新源地址——否则下次 install 仍按旧记录拉包。
