元数据加载失败主因是 packages.json 过期、未同步或格式不兼容，需换镜像源并确保配置正确、缓存清理到位；中科大源和华为云源同步更快，优先选用。
元数据加载失败，八成不是网络不通，而是你正在读一个过期、未同步或格式不兼容的 packages.json —— 换镜像源本身没用，关键得换对、配准、清干净。
为什么 composer update 一直提示 “Could not fetch packages.json”
这不是 DNS 或代理问题，是 Composer 在请求一个已失效或未同步的元数据地址。常见表现包括：
- 执行
composer update卡在 “Resolving dependencies” 几十秒后报错，-vvv日志里反复出现Downloading https://mirrors.xxx.com/composer/packages.json然后 404 或空响应 -
composer diagnose显示 “Repo: https://packagist.org”（说明镜像根本没生效） - 手动
curl -I https://mirrors.aliyun.com/composer/packages.json返回 200，但 Composer 还是失败 —— 说明它实际请求的是 provider 分片（如provider-laravel~10.0.json），而该镜像尚未同步这部分
中科大源（https://mirrors.ustc.edu.cn/composer/）和华为云源（https://mirrors.huaweicloud.com/repository/php/composer/）同步延迟通常控制在 5 分钟内，比阿里云/腾讯云更激进；若你依赖刚发布的包，优先切这两个。
composer config -g 配置后为啥还是走官方源
三个最常被忽略的硬性条件，缺一不可：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 键名必须严格为
repo.packagist（单数，不是repos或repositories）；Composer ≥ 2.2 则必须用repositories.packagist.org，且 value 是合法 JSON 字符串 - URL 必须以
/结尾，否则部分镜像会返回 301 重定向，旧版 Composer 解析失败 - 必须显式声明
type: "composer"，否则 Composer 会 fallback 到默认源校验，白配 - 项目根目录
composer.json中只要存在"repositories"字段（哪怕内容为空），全局配置就彻底失效
验证是否真生效：运行 composer config -g repo.packagist（或 repositories.packagist.org），输出应为完整 JSON 对象，且 url 值含你设的镜像域名；再跑 composer show -p | head -1，第一行显示的源域名必须匹配。
composer update --refresh 不起作用？先看版本和缓存路径
--refresh 是 Composer ≥ 2.5 才支持的参数，它只刷新元数据缓存（packages.json 和 provider-*.json），不碰 ZIP 包。但它不会自动重建缓存 —— 你得触发一次真实请求才会拉新。
- 确认版本：
composer --version；若 ≤ 2.4，只能手动删缓存目录：rm -rf $(composer config --global cache-dir)/repo/https---mirrors-ustc-edu-cn-composer（注意 URL 转义，和你当前镜像地址严格一致） -
composer clear-cache只清~/.composer/cache/files/下的 ZIP 和 dist 缓存，对元数据无效 —— 删错目录等于没做 - 删完不执行
composer update或composer show，缓存不会重建；别删完就以为搞定了
临时切源比永久配置更可靠
尤其在 CI、调试、或帮别人排查时，硬改全局配置容易污染环境，也难回溯。推荐这些更可控的方式：
- 单次命令强制指定：
composer update -vvv --repository-url=https://mirrors.ustc.edu.cn/composer/ - 仅当前项目生效（不写进
composer.json）：composer config repo.packagist composer https://mirrors.ustc.edu.cn/composer/ - 完全绕过所有配置，连
repositories字段都无视：composer install --repository-url=https://mirrors.huaweicloud.com/repository/php/composer/ --no-cache
真正卡点永远不在“有没有镜像”，而在“Composer 当前到底在用哪个 URL 请求哪一类元数据”。不验证真实请求域名，一切配置都是空中楼阁。
