Composer全局镜像配置失效的主因是键名错误、缺失type值或URL缺末尾/，三者任一出错均静默回退官方源；项目级repositories字段优先于全局配置，且必须执行clear-cache并验证-vvv日志中的域名。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能生效，但写错键名、漏掉 composer 类型、URL 缺末尾 /，三者任一出错都会静默回退到官方源——命令不报错，composer install 却还在下载 packagist.org。
为什么 composer config -g repo.packagist 总没反应
不是网络慢，是配置根本没被 Composer 读进去。常见原因有三个：
-
repo.packagist键名写成repos.packagist（多一个 s）：Composer 完全忽略该字段 - 中间漏掉
composer这个 type 值，例如写成composer config -g repo.packagist https://mirrors.tuna.tsinghua.edu.cn/composer/：Composer 5.0+ 会警告Repo is not configured properly，部分包仍走官方源 - URL 少了末尾斜杠，如
https://mirrors.ustc.edu.cn/composer：会拼出错误路径/composerpackages.json，返回 404
验证是否真写进去了：composer config -g repo.packagist 输出必须是完整 URL 字符串或 JSON 对象（如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}）。空、null 或还是 https://packagist.org，说明没成功。
全局配置 vs 项目级配置，哪个优先？
项目级配置永远优先于全局配置。只要项目根目录 composer.json 顶层有 "repositories" 字段，全局设置就自动失效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查项目是否已覆盖：进项目目录后运行
composer config repo.packagist，有输出说明项目自己写了源 - 想保留私有源又加镜像？别手写 JSON，用命令安全合并：
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/（不带-g） - 如果项目
composer.json的"repositories"是数组（比如含私有源），composer config命令会失败，需先手动转成对象形式："repositories": {}
换源后还卡在 Resolving dependencies 或 Downloading？
镜像只加速下载阶段，不解决依赖解析慢的问题。如果你发现 composer update 卡在 Resolving dependencies 几十秒以上，和镜像无关。
- 必须执行
composer clear-cache：旧缓存可能残留packagist.org元数据，导致仍尝试回源 - 检查
COMPOSER_HOME环境变量是否指向错误路径，导致配置加载错位置 - 企业网络可能拦截 HTTPS 请求，可临时试
http://mirrors.aliyun.com/composer/（仅调试，勿长期用） - CI 流水线中若用 Docker，必须把
/etc/composer/config.jsonCOPY 进镜像——构建时用composer config -g生成的配置对运行时用户无效
如何验证镜像真正在用？
别信“命令没报错”，要看真实请求地址：
- 运行
composer install -vvv 2>&1 | grep "Downloading" - 确认日志里出现的域名是
mirrors.aliyun.com、mirrors.tuna.tsinghua.edu.cn或packagist.mirrors.ustc.edu.cn，而不是packagist.org - 如果用的是系统级配置（
/etc/composer/config.json），必须用真实运行用户验证：sudo -u www-data composer config repo.packagist
最易被忽略的是：项目 composer.json 里一个多余的 "repositories" 字段，就能让所有全局配置失效；而 clear-cache 不执行，镜像再快也白搭。
