composer config -g repo.packagist 静默失效是因为必须同时满足三个硬性条件：键名必须为单数 repo.packagist、type 值必须显式写 composer、URL 必须 HTTPS 且末尾带 /；任一缺失即回退官方源，验证需输出完整 JSON 对象。
配不成功不是网络慢，是命令写错了三个硬性条件——漏掉任意一个，composer config -g repo.packagist 就会静默失效，不报错、不提示、也不走镜像。
为什么 composer config -g repo.packagist 总没反应？
这条命令看似简单，但 Composer 2.0+ 对键名、type 值、URL 格式做了严格校验，任一出错就直接 fallback 到官方源 https://packagist.org，且完全不提醒。
-
repo.packagist必须是单数形式（不是repos.packagist，也不是packagist.org） - 中间的
composer是必需的type值，不能省略，也不能写成package或composer.org - URL 必须是 HTTPS，且末尾必须带斜杠：
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、Key does not exist，或者还是https://packagist.org，说明根本没写进去 - 补救：检查是否用了
sudo执行（写进了 root 配置），或COMPOSER_HOME环境变量指向了错误路径 - 额外验证：运行
composer diagnose，看Repo.packagist.org这一行是否显示你的镜像地址
全局配置 vs 项目级配置，该用哪个？
全局配置（带 -g）只在你当前终端用户下生效；项目级配置（去掉 -g，在项目根目录运行）会写进 composer.json 的 repositories 字段，Git 可追踪，CI、宝塔、同事电脑都能一致行为。
- 个人开发机可先用全局：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 团队协作项目务必用项目级：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（进项目根目录后执行） - 注意：项目级配置优先级高于全局，哪怕你刚配好全局，只要
composer.json里有repositories字段，就会被覆盖且不报错 - 如果
composer.json中repositories是数组（[]），命令会失败；需先手动改为对象{}再重试
换源后 composer install 还卡在 Downloading？
镜像只加速下载环节，但旧缓存和锁文件会强行复用历史元数据地址，导致仍打向 packagist.org。
- 必须清缓存：
composer clear-cache - 必须删掉
vendor/和composer.lock - 再执行
composer install -vvv，观察日志中是否出现mirrors.aliyun.com或其他镜像域名 - 某些环境（如群晖 WebStation、宝塔）可能调用的是不同 PHP 路径，要用对应路径的
php执行命令，例如：/volume1/@appstore/PHP82/usr/bin/php /usr/local/bin/composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
最容易被忽略的点：镜像配置只是第一步，composer.lock 文件里硬编码了包来源和哈希，不删它，换再快的镜像也白搭。
