绝大多数时候Package not found就是包名拼错、大小写不对或漏组织名；先去Packagist搜完整vendor/package，确认存在且格式正确（小写vendor、斜杠顺序、无全角字符），再检查PHP版本约束与平台配置。
composer require 报错 Package not found 怎么快速定位是不是包名写错了
绝大多数时候，Package not found 就是包名拼错、大小写不对，或者压根没加组织名（vendor name）。Composer 不会模糊匹配，monolog 和 php-monolog 是两个完全不同的包，guzzlehttp/guzzle 不能简写成 guzzle。
- 先去 Packagist 页面搜你输的完整包名，比如
composer require laravel/ui，就去搜laravel/ui—— 如果搜不到，基本就是名字错了 - 注意斜杠前后顺序：
vendor/package，不是package/vendor；symfony/console对，console/symfony错 - 大小写敏感：有些包用下划线（
doctrine/orm），有些用短横线（nette/utils），但 vendor 名永远小写，且不能驼峰（MyVendor/my-package合法，MyVendor/MyPackage在 Packagist 上几乎不存在）
为什么 composer search 搜不到明明存在的包
composer search 默认只查本地缓存，而缓存可能过期或没初始化。它也不支持通配符，搜 log 不会返回 monolog/monolog。
- 运行
composer clear-cache再试一次composer search xxx - 更可靠的方式是直接上 Packagist 网页搜索，支持关键词、描述、标签过滤
- 如果确定包存在但搜不到，检查是否用了中文输入法——全角斜杠
／或空格混入会导致命令解析失败，错误信息可能是Invalid argument而非Package not found
私有包或 Git 仓库地址被当成包名输错
想从 Git 安装却漏写了 vcs 类型声明，或者把 GitHub URL 当作包名直传给 require，Composer 会当作一个公开包去 Packagist 查，自然找不到。
- 正确做法：先在
composer.json的repositories字段声明仓库类型和地址，再require对应的vendor/name - 常见错误写法：
composer require https://github.com/user/repo.git→ 报Package not found - 正确写法示例：
"repositories": [ { "type": "vcs", "url": "https://github.com/user/repo" } ]，然后composer require user/repo（注意 vendor/package 格式）
PHP 版本或平台配置导致包“不可见”
某些包在 composer.json 中声明了 php 版本约束（如 "php": "^8.1"），如果你本地是 PHP 7.4，即使包名完全正确，composer require 也会静默跳过或报“no matching package found”。
- 运行
composer show --platform确认当前识别的 PHP 版本和扩展是否符合目标包要求 - 临时绕过检查（仅调试用）：
composer require vendor/package --ignore-platform-req=php，但别提交到生产 - 检查
config.platform.php是否被手动设错（比如 CI 环境里硬编码了"platform": {"php": "7.2"}）
composer show --platform 和 Packagist 页面的 require 约束，比反复改包名更省时间。 
