Composer镜像配置没生效是因为键名必须为repo.packagist（单数）、第二个参数必须显式写composer（type值）、URL必须HTTPS且末尾带/，三者缺一即静默回退官方源。
镜像配置没生效，90% 是因为 composer config -g repo.packagist 这条命令根本没写进去——不是慢、不是网络差，是格式错一个就静默失败，Composer 会安静地退回 packagist.org。
为什么 composer config -g repo.packagist 总是返回空或 null
这不是权限或缓存问题，是命令本身没满足三个硬性条件：
- 键名必须是
repo.packagist（单数），写成repos.packagist、repositories.packagist.org或mirror都会被忽略 - 第二个参数必须显式写
composer，它是 type 值，漏掉就当普通字符串存，不识别为源 - URL 必须以
https://开头且末尾带/，例如https://mirrors.aliyun.com/composer/；少斜杠会拼出/composer/packages.json而非/packages.json，直接返回 404
唯一推荐写法：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。执行后立刻验证：composer config -g repo.packagist 输出必须是完整 JSON 对象或 URL 字符串，否则重试。
composer install -vvv 日志里先出现镜像域名，几秒后又切回 packagist.org
这不是配置失效，而是 Composer 2.2+ 的 fallback 行为：镜像返回 404 或 503 时自动切回官方源。常见于你要的包还没同步过去。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 打开镜像首页（如
https://mirrors.aliyun.com/composer/），看右下角“最后更新时间”，滞后超 30 分钟基本不用等 - 用
composer show -p vendor/package查包是否存在；若为空但官网能打开，说明镜像未收录 - 临时切回官方源测试：
composer config -g repo.packagist composer https://packagist.org，再composer require vendor/package --no-install -vvv
项目根目录有 composer.json，全局配置却完全不生效
只要项目级 composer.json 里存在 "repositories" 字段（哪怕只是空数组 "repositories": []），全局配置就被彻底屏蔽，且不 fallback。
- 快速确认：
composer config repo.packagist（不加-g），有输出说明被覆盖 - 检查方式：
grep -A 5 '"repositories"' composer.json，重点找已下线源（如laravel-china.org）或错误结构 - 不需要私有源时，删掉整个
"repositories": []块；需要保留时，确保第一个源是你配的镜像，并显式禁用官方源："packagist.org": false
换源后仍报 404、cURL error 60 或反复重试
大概率是缓存残留：Composer 缓存里存的是旧 packages.json 快照，包含过期的 dist 下载链接，不清缓存它就按旧元数据发起请求。
- 必须执行：
composer clear-cache，然后再composer install -vvv - 真实请求地址只看日志第一行：
composer install -vvv 2>&1 | head -n 10 | grep Downloading，域名必须匹配你配的镜像 -
cURL error 60不是镜像问题，是 PHP 的 OpenSSL 找不到 CA 证书或系统时间偏差超 5 分钟；查路径：php -r "print_r(openssl_get_cert_locations());"
最常被忽略的是：项目级 repositories 字段一旦存在，全局配置就彻底作废，连 fallback 都没有——这点在 CI/CD、宝塔、Docker 环境中尤其致命。
