真正有效的全局镜像配置命令只有一条：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/；键名必须为repo.packagist（单数、小写、无s）、中间参数composer为强制type值、URL须HTTPS且末尾带/，三者缺一即静默回退官方源，验证需输出完整JSON对象。
全局镜像配置只有一条命令真正有效，其他写法基本都静默失败——不是网络问题，是 Composer 对字段校验极严，错一个字符就不认。
composer config -g repo.packagist 命令为什么总不生效
它不报错，但也不起作用，典型表现是执行完 composer install 仍卡在 Loading composer repositories from packagist.org。根本原因只有三个硬性条件没满足：
- 键名必须一字不差：
repo.packagist—— 写成repos.packagist（多 s）、mirror、packagist.org或大小写混用（如Repo.Packagist）全被忽略 - 中间的
composer是type值，不是可选参数，也不能替换成vcs、package或留空 - 镜像 URL 必须是 HTTPS 且以
/结尾：https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404
验证是否真的写进去了
别信“命令跑完了”，必须手动验证：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config -g repo.packagist，输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 如果输出为空、
null、Key does not exist或仍是https://packagist.org，说明配置压根没写进去 - 再补查一次：
composer diagnose看Repo.packagist.org行是否显示你的镜像地址 - 临时加
--no-cache跑一次：composer update --no-cache -vvv，日志里应出现mirrors.aliyun.com的请求域名
全局配置 vs 项目级配置：什么时候该用哪一种
全局配置写入 ~/.composer/config.json（Windows 是 %APPDATA%\Composer\config.json），优先级高于项目级，但只对当前 shell 用户生效：
- 个人开发机用全局最省事：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 团队协作、CI/CD、宝塔或 Docker 环境必须用项目级：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g），它会安全追加到项目composer.json的repositories字段首位 - 注意：
composer config repo.packagist会**完全覆盖**整个repositories字段，已有私有仓库配置会被清空；若项目已有"repositories": []，需先手动改成"repositories": {}再重试
换源后还是慢或报错，下一步查什么
镜像只改下载路径，不参与依赖解析。如果 composer update 卡在 Resolving dependencies，和镜像无关：
- 检查
composer.json中的 PHP 版本约束（搜索"php"字段），太宽泛会导致解析爆炸 - 确认是否清过缓存：
composer clear-cache - 删掉
vendor/和composer.lock后重装 —— 否则旧 lock 文件仍按原元数据地址解析 - CI/CD 或宝塔中，确认实际执行命令的用户（比如
www或runner）是否也配了镜像，sudo composer config -g写的是 root 配置，但构建可能跑在普通用户下
最容易被忽略的点是：哪怕你反复执行了正确命令，只要项目 composer.json 里存在任何 repositories 字段（哪怕内容为空），全局配置就彻底失效。这不是 bug，是 Composer 的设计逻辑。验证前务必先 cd 进项目，再运行 composer config repo.packagist 看有没有输出。
