composer search 搜不到包是因为默认仅检索 Packagist 官方源且仅支持包名和 description 前缀匹配，不支持模糊或全文搜索；应优先用官网网页搜索、检查镜像源、确认包归属（如私有包、插件、商业产品等）。
composer search 搜不到包？先确认源和关键词是否匹配
composer search 默认只查 Packagist 官方源，且不支持模糊匹配或描述字段全文检索。它只搜索包名（vendor/name）和 description 字段的 前缀匹配，比如搜 log 能命中 monolog/monolog，但搜 logging 就可能空手而归。
- 搜索时尽量用包名中的核心词，比如想装 Redis 客户端，优先试
redis、predis、phpredis，而不是cache或client - 如果知道作者名，直接组合搜索：
composer search symfony/http-foundation（注意斜杠不能省） - 国内用户常因源被墙导致超时或返回空，可临时切镜像：
composer config -g repo.packagist composer <a href="https://www.php.cn/link/dc02ae8025eef0ecde61b00bb780abdb">https://www.php.cn/link/dc02ae8025eef0ecde61b00bb780abdb</a>（但该镜像已停更，现推荐<a href="https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19">https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19</a>配合代理，或改用阿里云源：composer config -g repo.packagist composer <a href="https://www.php.cn/link/1569ae888190eb8c53b218b0d529e1e9">https://www.php.cn/link/1569ae888190eb8c53b218b0d529e1e9</a>）
替代方案：用 Packagist 网页搜索更可靠
命令行 composer search 功能有限，真正找扩展包，90% 的情况应该打开 https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19 直接搜。网页版支持：
-
description、readme、tags 全文检索
-
按 PHP 版本、下载量、更新时间、是否 abandoned 过滤
-
点进包页能一眼看到
require写法、最低 PHP 版本、是否有 LTS 标签 -
别在命令行死磕，搜
jwt没结果？网页搜“JWT authentication”试试，常会冒出firebase/php-jwt、lcobucci/jwt这类名字不带 jwt 但功能明确的包 -
注意看包页右上角的
abandoned标签——比如ircmaxell/password-compat已弃用，但composer search password仍可能把它排前面
怎么判断一个包是否真能用？看 require 和 stability
搜到包只是第一步，composer require 前必须检查两件事：
- 查看它的
require是否和你项目冲突，尤其php版本和ext-xxx扩展依赖。比如ext-gmp在某些 Docker 镜像里默认不启用，装了也跑不起来 - 注意包的稳定性标记：
dev-、alpha、beta版本默认不会被安装（Composer 默认只取stable），要手动加--stability=dev或改minimum-stability配置，但生产环境慎用 - 包的
autoload类型是否匹配你的使用方式？比如有些包只提供psr-4，但你在非 Composer 环境下 require_once，就可能找不到类
composer show monolog/monolog 这句比 search 更有用，能直接看到版本、依赖、自动加载配置，避免“装上了却用不了”的尴尬。
为什么有些插件搜不到？它们根本不在 Packagist 上
Composer 本身不区分“扩展包”和“插件”，但实际中存在几类搜不到的东西：
- 自研私有包：没提交到 Packagist，需在
composer.json里手动加repositories指向 Git URL 或 Satis 服务 - Composer 插件（如
hirak/prestissimo）：属于 CLI 工具增强，不是项目依赖，得用composer global require，且部分插件要求 Composer 2.x 才支持 - Laravel Nova、Statamic 这类商业产品：官网下载 ZIP 后需手动配置本地 path repository，不可能被
search扫到
别把“插件”当普通包去搜。先想清楚你要的是运行时依赖，还是开发期工具，或是闭源产品——路径完全不同。
Packagist 不是应用商店，它只是个索引。搜不到，大概率不是命令不对，而是你对包的归属和分发方式理解有偏差。
