答案：composer报错“package not found”或“could not find a matching version”主因是镜像源未同步（延迟5–30分钟）、本地元数据缓存过期未刷新、或项目级repositories字段静默覆盖全局镜像配置；应通过访问镜像url验证、执行composer config --global repo.packagist composer https://packagist.org临时切源、并检查/删除项目级repositories来排查。
包在 packagist.org 上明明存在，composer require vendor/package 却报 Package not found 或 Could not find a matching version——这几乎可以确定不是包不存在，而是你本地 Composer 拉到的元数据（packages.json）太旧，或者镜像源压根没同步到那个版本。
确认是不是镜像源不同步导致的
国内镜像（阿里云、腾讯云等）对 packagist.org 的同步有 5–30 分钟延迟，高峰期可能更久。新发布的包或刚更新的版本，在镜像里可能还没出现。
- 打开浏览器访问
https://mirrors.aliyun.com/composer/p/vendor/package-name.json（把vendor/package-name替成你要查的包），如果返回 404 或内容里没有目标版本，就是镜像没同步 - 同时打开
https://packagist.org/packages/vendor/package-name确认官网确实已发布 - 运行
composer config -g repositories.packagist.org，确保输出的是你期望的镜像地址，且url值末尾带/
为什么 composer clear-cache 有时没用
composer clear-cache 会清掉 ZIP 包和部分元数据缓存，但它不会强制重新下载远程的 packages.json——Composer 默认复用本地缓存中未过期（15 分钟内）的元数据快照。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 即使你刚换完镜像，只要缓存里的
packages.json还没过期，Composer 就继续读它，根本不去镜像站拉新数据 - 执行
composer update --dry-run -v，看日志里是Reading from cache还是Downloading https://...；后者才说明真在刷新 - 真正要删的是缓存目录下的具体镜像子路径，比如：
rm -rf ~/.composer/cache/repo/https---mirrors-aliyun-com-composer
临时绕过镜像验证问题根源
别改配置文件，用命令行参数临时切回官方源，能快速判断是不是镜像的问题：
- 运行
composer config --global repo.packagist composer https://packagist.org（注意不是--unset） - 立刻执行
composer require vendor/package -vvv，观察是否成功下载 dist 包 - 若成功，说明问题出在镜像；失败则可能是包名拼错、稳定性约束（
"minimum-stability"）、或私有源配置干扰 - 验证完记得切回镜像：
composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/，再跑一次composer clear-cache
项目级 repositories 字段会静默覆盖全局镜像
这是最隐蔽也最容易被忽略的坑：只要项目根目录的 composer.json 里存在 "repositories" 字段（哪怕只是空数组 {}），全局镜像配置就完全失效。
- 运行
grep -A 5 '"repositories"' ./composer.json查看是否定义了该字段 - 如果存在，且里面写的是已停用的旧镜像（如
https://packagist.phpcomposer.com），就会导致所有请求都失败 - 临时禁用项目级配置：
composer config --unset repositories（不加-g），再试composer install - 长期方案是删掉或修正
composer.json中的repositories，确保 URL 以/结尾且指向当前可用镜像
真正卡住的点往往不在网络或权限，而在 Composer 对元数据缓存的“信任惯性”——它宁可复用 14 分钟前的快照，也不愿多发一次 HTTP 请求。手动删缓存目录、强制 --refresh、检查项目级覆盖，三者缺一不可。
