composer全局镜像配置生效需同时满足五要素：键名必须为repo.packagist（单数）、显式指定type值composer、url以/结尾、必须加-g参数、执行后需clear-cache；任一缺失即静默回退官方源。
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 这条命令就能全局生效，不需要改文件、不依赖环境变量、也不用重启终端——但漏掉任何一个细节，它就会静默失败，继续走官方源。
为什么 composer config -g repo.packagist 常常“没反应”
这不是命令没运行，而是 Composer 2.2+ 对配置字段极其敏感，写错一点就完全忽略，且不报错：
-
repo.packagist必须是这个 exact 键名：写成repos.packagist、packagist.org或repositories.packagist都无效 - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，少斜杠就是 404 - 必须显式传入
composer作为 type 值：命令里缺这个字，Composer 就 fallback 到packagist.org - 没加
-g参数 → 只改当前项目composer.json，换目录就失效 - 执行后没跑
composer clear-cache→ 本地元数据缓存仍指向旧源，一切白配
验证是否真在用阿里云镜像
别靠“好像快了”判断，要查实际生效的配置和网络请求：
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，输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 运行
composer diagnose，看 “Repo” 行是否显示阿里云地址；若仍是https://packagist.org，说明被项目级repositories覆盖了 - 跑一次
composer update -vvv，观察日志里Downloading的域名是不是mirrors.aliyun.com—— 这才是最终确认
项目级配置覆盖全局？怎么破
只要项目根目录的 composer.json 里有 repositories 字段，哪怕只写了空对象或 {"packagist.org": false}，全局镜像就完全不生效。
- 检查方式：
grep -A5 "repositories" composer.json，或直接打开文件搜索 - 临时解决：
composer config --unset repositories（注意不加-g），再补一句composer clear-cache - 如果项目模板自带禁用源但没配替代源，删掉
repositories字段后必须跑composer clear-cache，否则旧缓存仍可能触发packagist.org请求 -
composer.lock里硬编码了原始 dist 地址，旧 lock 会绕过镜像；真正走新源得删掉vendor/和composer.lock再install
composer global require 不走镜像？那是两套配置
全局命令读的是 ~/.composer/composer.json（全局项目的配置），和全局 config（~/.composer/config.json）是分开的。现象是明明 config -g 过了，composer global require larastan/larastan 却卡在下载 packages.json。
- 解决方法：进
~/.composer目录，运行composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 验证是否生效：
composer global show -s会列出当前全局项目的仓库配置 - 别用
--no-plugins或错误设置COMPOSER_HOME，会导致配置加载错位
git clone 类操作仍走原地址，这点容易被忽略。另外，composer.lock 里的 dist URL 如果来自旧源，即使镜像已切换，首次 install 仍可能失败，必须清缓存 + 清 lock 文件才能彻底切换干净。
