直接执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/即可生效，但漏-g、键名错（如repos.packagist）、URL缺末尾/或缺composer类型值均会静默失败，导致仍卡在“Loading composer repositories”；验证需composer config -g repo.packagist输出完整JSON且composer install -vvv日志显示镜像域名。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能生效，但漏掉 -g、写错键名、少斜杠或缺 composer 类型值，都会静默失败——你根本看不到错误，只看到卡在 Loading composer repositories。
为什么 composer config -g repo.packagist 总是不生效
不是网络问题，是 Composer 2.x 对配置字段极其严格，写错一个字符就当没配：
-
repo.packagist必须是单数，写成repos.packagist或packagist.org会悄悄写进无效字段 - 中间的
composer是必填type值，不是可选参数；漏掉它，Composer 直接 fallback 到packagist.org -
https://mirrors.aliyun.com/composer/末尾必须带/，少一个就会拼出/composerpackages.json，返回 404 -
-g不可省：缺了就只改当前项目composer.json，换目录或新开终端就失效
怎么验证镜像真正在用
别信“命令回显 OK”，得看两处输出：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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、或仍含packagist.org都说明失败 - 跑
composer install -vvv 2>&1 | grep "Downloading"，日志里必须出现mirrors.aliyun.com或mirrors.tuna.tsinghua.edu.cn；只看到packagist.org就等于没走镜像 - Windows 用户改完要重启终端；CI 流水线里若用
sudo执行，可能写进了root的配置，但构建用的是runner用户，读不到
项目级配置比全局更可靠
尤其在团队协作、CI/CD 或宝塔面板中，全局配置常因用户权限或环境隔离失效：
- 进项目根目录（有
composer.json的地方），运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加-g） - 这条命令会自动向
composer.json的repositories字段安全追加"packagist"条目，不覆盖已有私有源 - 如果
composer.json原本是"repositories": {}，它会转为标准对象格式；如果是"repositories": []，命令会失败，需先手动改成对象 - 改完必须删掉
vendor/和composer.lock，再跑composer install --no-cache；保留旧composer.lock会导致hash does not match
真正麻烦的从来不是换源本身，而是你以为配好了，其实请求压根没发出去——因为缓存没清、lock 文件没删、或者项目里写了 "packagist.org": false 把全局镜像彻底屏蔽了。
