Composer config -g repo.packagist 命令总不生效是因为漏掉 repo.packagist（必须单数）、composer（type 值不可省略）或 URL 末尾 / 中任意一项，导致静默回退官方源；验证需输出完整 JSON 对象如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，空、null 或报错即失败。
composer config -g repo.packagist 命令为什么总不生效
不是网络慢，也不是镜像站挂了，而是命令根本没写进配置——漏掉 repo.packagist、composer 或末尾 / 中任意一个，就会静默回退到 https://packagist.org，不报错、不提示、也不覆盖旧值。
必须同时满足三件事：
-
repo.packagist是唯一合法键名（注意是 repo 单数，写成repos.packagist或repository.packagist全无效） - 中间的
composer是type值，不是注释，不能省略，也不能替换成package或其他字符串 - URL 必须是 HTTPS，且末尾必须带
/：比如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404
验证是否真写进去了？别信终端没报错，运行：composer config -g repo.packagist。正确输出应为完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回空、null 或提示 Key does not exist，说明失败。
项目级配置比全局更可靠的真实原因
你在本地终端配好全局镜像，但宝塔后台、GitHub Actions、Docker 容器、同事电脑上照样连不上——因为它们根本读不到你 ~/.composer/config.json（Windows 是 %APPDATA%\Composer\config.json），用户身份不同，配置路径就不同。
项目级配置直接写进 composer.json，天然可提交 Git，所有环境行为一致：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 进项目根目录（确保有
composer.json），执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 它会自动在
repositories字段下追加"packagist": {"type": "composer", "url": "..."}，不破坏已有私有源 - 如果项目已有
"repositories": []（数组形式），该命令会报错；需先手动改成"repositories": {}（空对象）再重试 - 改完必须删掉
vendor/和composer.lock，再跑composer install（不是update）
换源后仍卡在 “Loading composer repositories” 怎么排查
这不是镜像没生效，而是请求压根没发过去。常见干扰项：
- 项目
composer.json里已有"repositories"字段（哪怕只写了[]），会完全屏蔽全局配置 -
composer.lock文件里还存着旧的元数据地址，缓存也未清，Composer 优先读它 - 某些企业网络拦截 HTTPS 请求，可临时试
http://mirrors.aliyun.com/composer/（仅调试，勿长期用） - 权限问题：比如
COMPOSER_HOME环境变量指向错误路径，导致配置加载错位
实操建议：先运行 composer clear-cache，删掉 vendor/ 和 composer.lock，再执行 composer install -vvv，观察日志里是否出现 mirrors.aliyun.com 或对应镜像域名。
阿里云、腾讯云、华为云镜像怎么选
三个镜像都可用，但细节差异影响稳定性：
- 阿里云地址：
https://mirrors.aliyun.com/composer/—— 同步及时、延迟低，目前最推荐 - 腾讯云地址：
https://mirrors.cloud.tencent.com/composer/—— 末尾带/，兼容性好 - 华为云地址：
https://mirrors.huaweicloud.com/repository/php/—— 末尾不带/，但composer config会自动补全；实际托管在 OBS，新包同步偶尔滞后
遇到某个镜像返回 404 或 503，可临时切回官方源调试：composer config -g --unset repo.packagist。但别长期依赖官方源——DNS 解析慢、TLS 握手卡、首字节延迟常超 300ms，不是“网速问题”，是架构级不可用。
