composer config -g repo.packagist 静默失效是因为必须同时满足三个硬性条件：键名严格为单数 repo.packagist、type 值显式写 composer、URL 为 HTTPS 且末尾带 /；任一缺失即静默回退官方源，验证需输出完整 JSON 对象。
配不成功不是网络慢，是 composer config -g repo.packagist 命令漏了三个硬性条件中的任意一个——它会静默 fallback 到 https://packagist.org，不报错、不提示、也不走镜像。
为什么 composer config -g repo.packagist 总没反应
这条命令根本不是“没反应”，而是校验失败后直接放弃写入。Composer 2.0+ 要求三者同时满足，缺一即无效：
-
repo.packagist必须是单数形式，写成repos.packagist或packagist.org都会被忽略 - 第二个参数必须显式写
composer，它是type值，不能省略，也不能替换成https、package或其他字符串 - 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 repo.packagist composer https://mirrors.aliyun.com/composer/ - 如果
composer.json中repositories是数组[]，命令会失败；需先手动改为对象{}再重试 - 项目级配置优先级高于全局，哪怕你刚配好全局，只要
composer.json里有repositories字段，就会被覆盖且不报错 - 宝塔、GitHub Actions、Docker 容器里默认不读你的全局配置，因为它们用的是不同用户的
~/.composer/config.json
换源后 composer install 还卡在 Downloading
镜像只加速下载环节，但旧缓存和锁文件会强行复用历史元数据地址，导致仍打向 packagist.org。
- 必须清缓存：
composer clear-cache - 必须删掉
vendor/和composer.lock - 必须运行
composer install（不是update），让 Composer 从头解析依赖、生成适配新镜像的 lock 文件 - 如果日志里仍出现
packagist.org或请求超时，说明配置根本没生效，回头重查三个硬性条件
最容易被忽略的一点是：哪怕你把命令全写对了，只要 composer.json 里已有 repositories 数组（哪怕为空），composer config repo.packagist ... 就会静默失败——它不会自动转数组为对象，也不会报错提醒你手动改。
