问题根源在于元数据缓存过期、镜像源未同步或 repositories 配置覆盖导致包不可见；需验证源可用性、清理 provider 缓存、检查版本 tag 或 branch-alias 是否合规。
包名拼写正确、网络通畅、镜像配置无误，却仍报 Could not find package？问题大概率出在元数据缓存、源配置优先级或版本可见性上——不是“没连上”，而是“根本没看到”。
确认包是否真在你当前用的源里
Composer 不会跨源搜索，它只查 composer config -g repo.packagist 或项目 composer.json 里声明的源。哪怕 Packagist 官网有这个包，如果你配了阿里云镜像但该包还没同步过去，就会 404。
- 运行
curl -I https://mirrors.aliyun.com/composer/p/vendor/name.json，看返回状态码是不是HTTP/2 200；若为404，说明镜像还没同步 - 对比官方源：
curl -s https://packagist.org/packages.json | jq -r '.lastModified'和镜像源对应命令，时间差超 10 分钟就别等了 - 临时切回官方源验证：
composer config -g repo.packagist composer https://packagist.org/，再跑composer show vendor/name - 注意 Laravel China 镜像（
packagist.laravel-china.org）已停服，还在用必报错
检查 repositories 配置是否被项目覆盖
只要项目根目录 composer.json 里写了 "repositories" 字段，全局镜像就完全失效——哪怕你只加了一条私有 Git 地址，Composer 也会忽略所有其他源，包括 Packagist。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行
composer config --list | grep repositories，有输出即表示项目自己管源 - 打开项目
composer.json，检查repositories是否漏掉{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}这条显式声明 - 若只配了私有 Git 源但又想保留 Packagist，必须手动补上官方镜像源，且
type必须是composer，不能省略 - URL 末尾必须带
/，否则拼成https://mirrors.aliyun.com/composerpackages.json直接 404
验证 provider 元数据缓存是否过期
composer clear-cache 只清 ZIP 包和 dist 缓存，对决定“能看到哪些包”的 provider-*.json 文件毫无影响。旧 provider 缓存会让 Composer 坚信某个包“不存在”，哪怕镜像早已同步。
- 先查缓存路径：
ls -d ~/.composer/cache/repo/https---mirrors.aliyun.com-composer（Linux/macOS）或%APPDATA%\Composer\cache\repo\https---mirrors.aliyun.com-composer（Windows） - 直接删掉整个目录：
rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer - Composer ≥ 2.5 可用更精准的
composer update --refresh，它专清 provider 级缓存 - 删完立刻跑
composer show vendor/name，Composer 会重新拉取最新 provider 数据
确认你要装的版本是否被 Composer 认作“可安装”
Composer 不认任意分支名或 tag，只认两类东西：打了规范 tag（如 v1.2.3 或 1.2.3）的 release，或在 composer.json 里声明了 branch-alias 的开发分支（如 "dev-main": "1.0.x-dev"）。
- 运行
git ls-remote --tags https://github.com/vendor/name，确认 tag 存在且格式合法（不能是release-1.0或v1.0_final） - 查看该包仓库的
composer.json，确认extra.branch-alias是否存在且 key 与你 require 的分支名一致（dev-main对应"dev-main": "1.0.x-dev"） - 若没配
branch-alias，composer require vendor/name:dev-main会失败；可临时加@dev强制：composer require vendor/name:dev-main@dev - 某些镜像会策略性过滤
dev-开头的分支，这不是 bug，是主动跳过
最常被忽略的是：删了缓存却没删 provider 目录，切了镜像却没验证 composer config -g repo.packagist 输出是否真变了，以及——私有包没在 repositories 里声明 type: "vcs" 就直接 require，结果当然找不到。
