Could not find package 错误主因是 Composer 默认仅查 Packagist 的 stable 版本且不自动降级稳定性或扫描私有源；90% 问题可通过确认包名拼写、检查 Packagist 是否上线、核查项目 stability 约束三步定位。
直接说结论：Could not find package 不是包真没了，而是 Composer 默认只查 Packagist 上的 stable 版本，且不自动降级稳定性、不自动扫描私有源。90% 的“不存在”问题，靠三步就能定位：确认包名拼写、查它在 Packagist 是否上线、看当前项目的稳定性约束是否拦住了它。
包名拼写或命名空间错误
Composer 对大小写、连字符、组织名极其敏感，错一个字符就找不到。比如 laravel/sanctum 写成 laravel-sanctum 或 Laravel/Sanctum 都会失败；spatie/laravel-permission 少个 laravel- 前缀也查不到。
- 用浏览器打开 https://packagist.org/packages/xxx/yyy，把包名完整粘贴进去，看是否 404
- 运行
composer search xxx（它查的是 Packagist 全量索引），如果能搜到但require失败，说明是约束或源的问题，不是包名错 - 私有包必须用完整 vendor/name 格式，不能省略组织名——哪怕你本地 Git 仓库叫
myrepo，在repositories里声明后，require时仍得写myorg/myrepo
包存在但被 stability 约束过滤掉了
很多新包、开发分支、beta 版本默认被 "minimum-stability": "stable"（这是 composer.json 的默认值）直接屏蔽。你看到的 Could not find package，其实是“找到了，但被规则拒了”。
- 检查项目根目录
composer.json中是否有"minimum-stability"字段；如果没有，Composer 就按stable处理 - 临时试装 dev 版：运行
composer require vendor/name --stability=dev --prefer-source，成功就说明是稳定性问题 - 不推荐长期改
minimum-stability到dev，容易引发全量升级失控；更稳妥的做法是在 require 时单独指定稳定性，或用--no-update先写入再精准 update
包不在 Packagist，也没配置自定义源
私有 Git 仓库、内部 Nexus、GitHub Gist 类包，不会自动出现在 Packagist，必须显式告诉 Composer “去哪找”。漏配 repositories 是 CI 环境和新同事本地首次 install 失败的头号原因。
- 在
composer.json根对象下添加repositories数组，类型必须是vcs，URL 必须可访问（HTTPS 优先，SSH 需配置密钥）：
"repositories": [
{
"type": "vcs",
"url": "https://github.com/myorg/internal-tool"
}
]
- 加完记得删掉
vendor和composer.lock（或至少运行composer update --lock），否则旧锁文件会继续走默认源 - 配置后仍失败？用
composer config repositories确认源已生效；再用composer show -p查看所有可用包，确认你的包是否出现在列表里
为什么 composer show vendor/name 显示 no such package？
这个命令返回 “no such package” 并不意味着包绝对不存在，只代表它没进当前项目的依赖解析树——可能因为版本冲突被跳过、被 replace 规则排除、或根本没被任何已安装包引用。
- 先运行
composer why-not vendor/name ^2.0（替换为你想装的版本），它会告诉你哪个已装包的约束卡死了这个包的安装路径 - 如果
why-not也报 no such package，说明该包完全未参与解析——这时候才该回头检查拼写、源、stability 这三板斧 - 注意：有些包（如 Laravel 的官方插件）要求根项目是 Laravel 应用，否则会被自动忽略；这类依赖需配合
composer create-project laravel/laravel初始化后再加
最容易被忽略的一点：Composer 的 show、search、require 走的是三套不同逻辑。能 search 到 ≠ 能 require 成功；show 不出来 ≠ 包不存在。排查时别跳步骤，老老实实从包名、源、稳定性、锁文件这四个真实变量开始验证。
