答案是镜像同步延迟、本地provider缓存过期、包名拼写错误或私有源未配置；应先验证包在packagist.org是否存在，再检查镜像URL格式、配置是否生效、清理对应provider缓存，而非仅用clear-cache。

“Could not find package”不是包真没了，而是 Composer 没在当前配置的源里查到它——90% 的情况是镜像没同步、缓存过期、包名拼错，或私有源根本没被触发。

确认包名和版本是否真实存在

别急着清缓存或换源，先验证这个包是不是真的能装：

• 打开 https://packagist.org/packages/vendor/name（把 vendor/name 换成你实际要装的），看页面是否 200 可访问；如果 404，说明 Packagist 根本没收录这个包
• 运行 composer search vendor/name，有结果才代表它在 Packagist 索引里；没结果就别硬装
• 检查大小写：比如 monolog/monolog 对，Monolog/monolog 就错；spatie/laravel-backup 对，spatie/backup 就错
• 复制包名时小心不可见字符——从网页或微信粘贴容易带全角空格或零宽字符，建议手动重打一遍

排查镜像是否生效或已失效

国内镜像不是万能的，它只缓存 Packagist 已有的内容，且存在延迟或主动过滤：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的 JSON；如果为空、报错，或 URL 是 https://packagist.phpcomposer.com（已停用），说明镜像没配对
• URL 必须以 / 结尾：https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌
• Composer ≥ 2.2 要求键名是 repos.packagist（复数），写成 repo.packagist 会静默忽略
• 临时切回官方源验证：composer config -g repo.packagist composer https://packagist.org，再跑 composer show vendor/name；如果官方能查到、镜像查不到，基本就是同步延迟（阿里云/腾讯云通常滞后 1–6 小时）

清理 provider 缓存，不是 clear-cache

composer clear-cache 清的是 dist 包和 zip 缓存，对 “找不到包” 几乎无效。真正卡住的是本地 provider 缓存（如 packages.json、provider-laravel-packages.json）：

• Linux/macOS：rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer
• Windows：rd /s /q "%APPDATA%\Composer\cache\repo\https---mirrors.aliyun.com-composer"
• 删完不用重启终端，直接再试 composer show vendor/name
• 注意：不要用 composer clear-cache 代替这步——它清不到 provider 层，问题照旧

私有包或新发布包必须显式声明源

私有包、GitHub/GitLab 仓库、未提交到 Packagist 的新包，Composer 默认完全不查它们：

• 必须在项目根目录 composer.json 的 repositories 字段里声明，例如：

  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/username/repo"
    }
  ]

• url 值末尾不能有 /，否则部分代理会返回 404
• 确保该 Git 仓库根目录有合法的 composer.json，且其中 name 字段严格匹配你 require 时写的 vendor/name
• 如果仓库需要认证（如私有 GitLab），必须配 auth.json 或用 composer config http-basic.xxx 显式存凭证，域名要和 repositories.url 主机名完全一致

最常被忽略的一点：项目级 composer.json 里只要写了 "repositories": []（哪怕空数组），全局镜像配置就会彻底失效——Composer 会直接 fallback 到 packagist.org，连你配的阿里云都懒得碰。排查时务必先 composer diagnose 看它到底在连哪个源。