答案是Composer中文镜像“更新失败”主因是配置未生效、缓存未清理或命令错误，而非镜像失效；需用composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（键名、-g、type、尾斜杠四要素缺一不可），并执行composer update --refresh清除元数据缓存。
不是镜像本身失效，而是你根本没连上它——Composer中文镜像“更新失败”绝大多数时候是配置未生效、缓存未清理或命令用错，不是镜像挂了。
composer config -g repo.packagist 写错了键名
很多人输成 repos.packagist（多一个 s），或者漏掉 -g 参数，结果改的只是当前项目 composer.json，换个项目就失效。正确写法只有一条：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/- 执行后立刻验证：
composer config -g repo.packagist输出必须是完整 JSON，且url字段值为"https://mirrors.aliyun.com/composer/"（结尾带斜杠） - 别信
composer config --list | grep repositories的模糊输出，它可能混着项目级和全局配置，误导判断
项目级 repositories 配置会彻底屏蔽全局镜像
只要你的 composer.json 里有 "repositories" 字段，哪怕内容是 {"packagist.org": false} 或空对象 {}，Composer 就自动放弃所有全局镜像设置，直连 packagist.org——而这个域名在国内已基本不可达。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 打开项目根目录
composer.json，搜索"repositories"，删掉整段（保留缩进格式） - 临时验证：运行
composer config --unset repositories（不加-g），再试composer update - ThinkPHP、Laravel 官方模板常自带过时镜像声明，刚 clone 下来就该先删
clear-cache 清不掉元数据缓存，--refresh 才是正解
composer clear-cache 只删 ZIP 包和 provider 缓存，但本地缓存的 packages.json（默认 15 分钟不过期）仍被复用，导致 composer update 根本不去镜像站拉新数据，静默卡在 0 installs, 0 updates。
- 确认 Composer 版本：
composer --version，必须 ≥ 2.5 才支持--refresh - 强制刷新元数据：
composer update --refresh，它丢弃所有packages.json缓存，只从当前生效镜像源重拉 - 老版本（≤ 2.4）只能手动删：
rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer
self-update 和 update 走的是完全不同的通道
你设了阿里云镜像，composer update 能走镜像，但 composer self-update 根本不读 repo.packagist 配置——它直连 https://getcomposer.org/，所以换镜像对自更新无效。
-
self-update失败常见于：网络拦截（GitHub Releases API）、权限不足（/usr/local/bin/composer不可写）、PHP 版本低于 8.0 却硬升到 2.5+ - 绕过 PHP 禁用函数（如宝塔里报
putenv() has been disabled）：/www/server/php/82/bin/php -d "disable_functions=" /usr/local/bin/composer self-update - 升级后务必重设镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，因为self-update会清掉旧配置
最易被忽略的点：镜像 URL 必须带尾部斜杠，https://mirrors.aliyun.com/composer（缺 /）会导致 404；插件不兼容（如 hirak/prestissimo）会让 update 停在 0 installs, 0 updates 却不报错；parallel-downloads 对 update 阶段无加速效果，只影响 install 下载 ZIP。
