composer search不支持按tag搜索，因该命令仅匹配包名和描述字段，不解析版本标签；查tag需先定位包名，再通过packagist api（如/packages/{v}/{p}.json）或composer show --all查看versions字段。
composer search 不支持直接按 tag 搜索
Composer 的 composer search 命令只支持按包名（name）和描述（description）的全文关键词匹配，不识别、不解析、也不过滤 packagist.org 上的版本标签（如 v1.2.0、stable、dev-main）或自定义标签（如 @alpha、@dev）。你执行 composer search foo --tag=beta 或类似写法会报错或被静默忽略——因为该命令根本没有 --tag 参数。
想查某个包是否发布了带特定 tag 的版本？用 packagist.org 网页 + API 更可靠
Packagist 是 Composer 的元数据源，所有 tag 信息都来自其 API。实际操作分两步：
- 先用
composer show查本地已安装包的可用版本（含 tag），但仅限已 require 过的包； - 要查未安装包的 tag，得调用 Packagist API：
https://packagist.org/packages/{vendor}/{package}.json（例如https://packagist.org/packages/guzzlehttp/guzzle.json），返回 JSON 中的versions字段就是全部带 tag 的版本列表，包括"dev-master"、"2.1.0"、"1.x-dev"等。 - 若只想快速确认是否存在
v3.0.0或@rc类 tag，用curl -s "https://packagist.org/packages/vlucas/phpdotenv.json" | jq '.versions | keys[]' | grep -i "rc\|beta\|v3"（需装jq）比人工翻网页快得多。
本地项目中验证某 tag 是否可安装？用 composer show + 版本约束测试
即使 API 显示存在 v2.4.0，也得确认它是否满足当前项目的 stability 要求（比如 "minimum-stability": "stable" 会跳过 dev- 和 alpha 标签）。实操建议：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer show vendor/package --all：列出所有已知版本（含 tag），但依赖本地缓存，可能滞后； - 加
-vvv后执行composer require vendor/package:v2.4.0：观察输出里是否出现Could not find package... or could not find a matching version，这是最真实的“该 tag 当前是否可用”判断； - 注意：某些 tag 是分支别名（如
dev-main对应 main 分支），不是真实 Git tag，composer show会显示，但git ls-remote查不到对应轻量 tag。
为什么不能靠 search + tag 组合？根源在 Packagist 搜索机制
Packagist 的搜索接口（https://packagist.org/search.json?q=xxx）只索引 name 和 description 字段，versions 是单独加载的关联数据，不在搜索上下文中。这也是为什么：
- 你在网页搜
laravel debugbar beta，结果是包含 “beta” 描述的包，而非带betatag 的barryvdh/laravel-debugbar； -
composer search本质是调这个 API 的封装，没额外逻辑； - 真正需要 tag 维度筛选时，必须切换到包级粒度（即先确定包名，再查它的 versions）。
绕不开的现实是：tag 不是包的属性，而是版本的快照标识——你得先锁定包，再钻进它的版本历史里找 tag。
