Composer config repo.packagist 不生效是因为三个硬性条件缺一不可：键名必须为单数 repo.packagist、中间必须显式写 type 值 composer、URL 必须 HTTPS 且末尾带 /；任一缺失即静默回退官方源，验证需输出完整 JSON 对象。
Composer自定义仓库（repositories）配置后依然慢，大概率不是镜像本身问题，而是配置没生效、缓存没清、或 Composer 仍在读旧的 dist.url——换源只是第一步，后续三步漏掉任何一步，composer install 都会卡在 Downloading 或 Loading composer repositories。
为什么 composer config repo.packagist 不生效？
这条命令静默失败是常态，不是 Composer 坏了，而是三个硬性条件缺一不可：
-
repo.packagist必须是单数、全小写、无空格或额外字符；写成repos.packagist（多 s）、packagist（少repo.）、mirror等全部无效 - 中间的
composer是type值，不是注释或可选项；漏掉它，Composer 2.2+ 直接 fallback 到官方源 - 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，说明根本没写成功。
换镜像后仍卡在 Downloading 某个包？
这不是镜像没生效，而是 composer.lock 里还存着旧的 dist.url，指向境外地址。Composer 会优先尝试这个链接，失败才 fallback，且 fallback 不保证成功。
必须执行：
composer update --lock
该命令强制重写 composer.lock 中所有包的 dist.url，替换成镜像源路径。不跑这步，哪怕镜像配置全对，下载阶段也大概率卡住。
顺手清缓存更稳妥：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer clear-cache
CI/宝塔/Docker 环境下全局配置为什么白配？
因为这些环境默认以 www、runner 或容器内非登录用户身份运行，读不到你个人用户的 ~/.composer/config.json。
更可靠的做法是项目级配置：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
注意：不加 -g，该命令会修改当前目录下的 composer.json，向 repositories 字段追加 packagist 条目。该配置随代码提交，团队成员拉取即生效，无需各自操作。
如果 composer.json 原本是 "repositories": {}，命令会自动转为数组并插入；如果是 "repositories": []，就追加到末尾。千万别手动写 "packagist": false——这会导致 php、ext-json 等基础扩展校验失败。
怎么确认镜像真的在用？
composer diagnose 显示 “OK” 不代表镜像可用，它只校验语法和本地连通性，不验证元数据是否完整。
真实验证方式有两个：
- 打开
composer.lock，搜索任意包（如hyperf/cache），看其dist.url字段是否为https://mirrors.aliyun.com/composer/dists/... - 用
curl -I https://mirrors.aliyun.com/composer/packages.json，必须秒回200 OK；若超时或返回503，得换源
阿里云、清华、SJTUG、php.cnpkg.org 四个主流源实测差异明显：阿里云通用性最强，清华北方快但南方偶发 DNS 慢，SJTUG 稳定但出口 IP 可能被限，php.cnpkg.org 更新最勤但文档弱。别再用已停更的 packagist.phpcomposer.com 或 packagist.laravel-china.org。
