答案是版本约束错误——90%因符号语义(^/~)、后缀(-beta/-dev)、稳定性标记(需@beta或minimum-stability)不匹配，或包名拼写、私有仓库未配置、缓存过期所致。
“Could not find a matching version” 几乎从不因为镜像源本身挂了，而是你写的版本约束根本没在当前生效的元数据里存在——要么它真没发布，要么你本地看到的“可用版本列表”是过期的。
composer show -a 才是你该信的唯一真相
别查文档、别看 Packagist 网页、别猜 ^ 和 ~ 的区别。运行 composer show -a vendor/package-name，输出里的 versions 行就是 Composer 当前能识别到的全部 tag 和分支（含 (dev)、(beta) 标记）。
- 如果返回
Package not found：包名拼错、大小写不对（Linux 下monolog/monolog≠Monolog/Monolog）、或项目级repositories配置屏蔽了所有源 - 如果返回了列表但你要的版本不在其中（比如你想装
^3.0，列表里只有2.8.1和dev-main）：不是镜像延迟，是那个版本确实没发布 - 如果列表里有
3.6.0@beta，但你写的是3.6.0：必须显式加@beta或配置minimum-stability
镜像不同步？先验证再动手
国内主流镜像（阿里云、腾讯云）对 Packagist 的元数据同步通常有 5–30 分钟延迟，高峰期可达数小时。但你不能靠“等”来解决——得验证。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
curl -I https://mirrors.aliyun.com/composer/p/vendor/package-name.json查响应头：Last-Modified时间是否接近当前时间？不是就说明没同步 - 对比官方源：
curl -s https://packagist.org/p2/vendor/package-name.json | jq -r '.packages."vendor/package-name" | keys[]' | sort和镜像源对应命令输出是否一致 - 运行
composer diagnose，看Repo packagist.org:后面显示的 URL 是否为你配的镜像地址（注意结尾斜杠）；若显示https://packagist.org/，说明全局配置失效或被项目覆盖
强制刷新元数据，不是清缓存
composer clear-cache 没用——它只删 ZIP 包和部分 JSON，不碰最关键的 packages.json 和 provider-*.json。真正有效的是让 Composer 丢掉旧索引、重拉最新元数据。
- Composer ≥ 2.5：直接跑
composer update --refresh，它只清理 provider 相关 JSON，不碰已下载的 ZIP，快且准 - 老版本：手动删元数据缓存目录，路径按镜像 URL 转义，例如
rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer - 临时绕过镜像验证：加
--no-cache参数，如composer show -a vendor/package --no-cache，强制走网络请求
项目级 repositories 是静默杀手
只要你在项目根目录的 composer.json 里写了 "repositories" 字段，Composer 就会彻底忽略全局镜像配置，哪怕你只加了一个私有 Git 地址，所有公共包（如 monolog/monolog）都会查不到。
- 检查方式：
composer config repos.packagist（不加-g），若有输出，说明项目自己管源 - 常见坑：模板里残留已停服的旧镜像（如
https://packagist.phpcomposer.com），结果所有请求都 404 - 临时禁用项目配置验证镜像：
composer show -d repo.packagist=composer vendor/package
最常被忽略的一点：你以为改了全局镜像就万事大吉，但项目里一行 "repositories" 就能让所有配置失效——而且不报错、不警告，只默默走错源。每次遇到“找不到版本”，先确认这一行是否存在，比重装 Composer 还管用。
