Composer报“Package not found”主因是镜像同步延迟（5–30分钟）、本地元数据缓存未刷新、项目级repositories覆盖全局配置、minimum-stability限制或PHP版本不兼容；需通过curl验证镜像状态、删缓存目录、临时切官方源及检查平台约束排查。
为什么 composer require 找不到包，却在 Packagist 上明明存在？
大概率不是包不存在，而是 Composer 没连上正确的源 —— 镜像配置出问题了。国内用户常配阿里、腾讯或华为镜像，但这些镜像同步有延迟（通常 5–30 分钟），且不保证 100% 覆盖所有私有/新发布/带特殊命名空间的包。
常见现象：Could not find package vendor/name，但打开 Packagist 页面 能正常访问；或者用 composer show vendor/name 查不到，但加 --all 却能列出。
- 先运行
composer config -g repo.packagist确认当前全局镜像地址（注意：返回{"type": "composer", "url": "..."}格式时，说明用了自定义 repo） - 若输出是类似
https://mirrors.aliyun.com/composer/，再用curl -I https://mirrors.aliyun.com/composer/p2/vendor/name.json直接测镜像节点是否返回200；返回404就坐实是镜像没同步 - 临时切回官方源验证：执行
composer config -g repo.packagist composer https://packagist.org，再试require—— 如果成功，基本锁定镜像问题
如何判断是镜像延迟还是包本身不兼容？
不是所有“找不到”都怪镜像。Composer 包检索依赖 composer.json 中的 minimum-stability 和 prefer-stable 设置，也受 PHP 版本、平台约束影响。
例如：某包只声明支持 php: ^8.1，而你本地是 PHP 7.4，即使镜像完整，Composer 也会跳过它并报“not found”。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 加
-vvv参数重试命令，如composer require vendor/name -vvv，观察日志里是否有Skipped package ... due to platform constraints - 检查包的
composer.json中require.php字段，对比php -v输出 - 运行
composer show --platform确认当前环境声明的平台能力是否匹配 - 若包是
dev-main或带@dev的开发版，确保minimum-stability没设成stable（否则直接过滤掉）
换镜像后仍失败？检查是否被 repositories 覆盖了源
项目级 composer.json 里的 repositories 会完全屏蔽全局镜像，优先走这里定义的源 —— 很多人忘了删测试时加的私有仓库配置。
典型错误配置："repositories": [{"type": "composer", "url": "https://example.com"}]，但该 URL 根本不提供 vendor/name 包，Composer 就不会 fallback 到 Packagist。
- 执行
composer config repositories查看当前生效的仓库列表 - 如果输出里有非官方源，且你并不需要它，用
composer config --unset repositories清空（或编辑composer.json手动删掉repositories字段） - 若必须保留私有源，需明确指定只对特定 vendor 生效：用
"packages"白名单，或把 Packagist 官方源显式加回来，type 设为composer，url 为https://packagist.org
镜像可用但搜索慢或漏结果？别忽略 composer clearcache
Composer 会缓存 packages.json 和 p2/ 索引文件，一旦镜像更新了数据，本地缓存没清，就会继续读旧索引 —— 表现就是“镜像页面能看到包，命令却找不到”。
- 不要只清项目级缓存：
composer clearcache是全局操作，必须运行（它清理的是~/.composer/cache） - 清除后，首次
require会重新拉取整个packages.json，耗时稍长，属正常现象 - 如果公司内网有代理或防火墙，缓存清理后仍卡在
Downloading https://xxx/p2/...，可加-d memory_limit=-1避免因内存不足中断下载
镜像排查最易被忽略的点：以为换了源就万事大吉，其实缓存、平台约束、项目级仓库配置这三处不动，换十次镜像也没用。
