composer search 经常搜不到包，因它仅匹配 packagist.org 的包名字段，不支持模糊搜索、不查描述/README，且受 abandoned 标记、网络超时、镜像同步延迟等影响；推荐用 composer show -p 配合 grep 或 jq 精准筛选。
composer search 命令为什么经常搜不到你要的包
因为 composer search 默认只查 packagist.org 的「包名（name）」字段，不搜描述、关键词或 README 内容。你输 composer search laravel-admin，如果作者没把 laravel-admin 写进 name（比如包名叫 encore/laravel-admin），它就直接不返回。
- 实际搜不到时，先去 packagist.org 网页手动搜，更准
-
composer search不支持模糊匹配或通配符，search laravel*会报错 - 某些包被标记为 abandoned，
search仍会返回，但安装时 Composer 会警告 - 国内网络不稳定时，
composer search可能超时失败，不是命令写错了，是请求根本没发出去
用 composer show -p 查本地已知包的完整列表
如果你只是想确认某个包是否存在、有没有装过、版本范围是否兼容，composer show -p 比 search 更可靠——它读的是 Packagist 的公开索引快照，不走实时 HTTP 请求，速度快、不丢包。
-
composer show -p | grep -i "debug"能快速筛出含 debug 的包名 - 加
--format=json可导出结构化数据，适合脚本解析：composer show -p --format=json | jq '.[] | select(.name | contains("log"))' - 注意：这个列表不含私有仓库的包，除非你已配置了对应 repo 并运行过
composer update --lock
遇到 “Package not found” 错误时的三步定位法
执行 composer require vendor/name 报这个错，90% 不是包不存在，而是 Composer 没“看见”它。
- 检查拼写：大小写敏感，
monolog/monolog对，monolog/Monolog错 - 确认源地址：运行
composer config repos.packagist.org.url，确保是https://packagist.org；若被改成镜像，某些新包可能同步延迟 - 清缓存再试：
composer clear-cache，尤其在换网络环境（比如从公司内网切到家用宽带）后，旧缓存常导致 404
搜索插件类包要盯紧 type 字段
很多 Laravel 或 Symfony 插件本质是 type: library，但真正起作用靠的是 extra.laravel.providers 或 extra.symfony.bundles 这类元信息。光搜名字没用，得看包的 composer.json 里有没有这些字段。
- 网页搜到包后，点进详情页，展开 “Composer.json” 标签页，直接 Ctrl+F 查
"type"和"extra" - 常见插件 type 值有：
laravel-package、symfony-bundle、wordpress-plugin—— 这些才是安装后能自动注册的信号 - 如果一个包 type 是
library，但文档说“支持 Laravel”，那大概率要手动注册服务提供者，不是即装即用
