Composer search搜不到中文包名或功能描述，是因为该命令仅对Packagist元数据中name和description字段做英文前缀匹配，不支持中文分词、拼音、模糊联想或全文检索；搜“微信”无效，搜“wechat”才可能命中，且未提交至Packagist的Gitee/GitHub包默认不可见。
不是 Composer 搜索能力弱，而是默认只查 Packagist 官方索引，且不支持中文关键词、描述全文匹配或模糊联想——搜“微信 SDK”大概率空手而归，但搜 overtrue/wechat 就能命中。
为什么 composer search 搜不到中文包名或功能描述？
Composer 的 composer search 命令只做两件事：查 Packagist 元数据中 name 和 description 字段的**前缀匹配**（不是子串，更不是语义），且完全忽略中文分词、拼音、空格或标点。搜 wechat 能出结果，搜 微信 或 weixin sdk 就几乎为零。
- 包名必须是英文 vendor/name 格式，如
topthink/think-swoole，不存在微信框架这种合法包名 - description 里写 “微信公众号 SDK” 的包，
composer search 微信不会触发匹配，composer search wechat才可能命中 - 国内开发者常把包托管在 Gitee/GitHub 但没提交到 Packagist，这类包根本不在
composer search的索引范围内
怎么让 Composer 查到 Gitee/GitHub 上的中文项目？
必须手动添加 vcs 类型仓库，并确保它在 repositories 数组中排第一——Composer 查包是「从上到下，命中即停」，不走完全部源。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在项目根目录
composer.json的repositories字段开头加一条：{"type": "vcs", "url": "https://gitee.com/xxx/yyy"}，URL 必须是可git clone的地址（带.git后缀更稳） - 如果同时要用 Packagist 公共包（比如
monolog/monolog），必须显式启用官方源并关闭自动注入：{"packagist.org": false}放在repositories第一项，第二项才是{"type": "composer", "url": "https://packagist.org"} - 改完立刻执行
composer clear-cache，否则旧缓存仍按老配置跑
镜像源同步延迟导致新包“搜得到但装不上”怎么办？
阿里云、腾讯云等镜像站对 Packagist 的元数据同步有 5–60 分钟延迟，刚发布的 v1.2.0 版本，在镜像里可能还查不到——这不是配置错误，是时间差问题。
- 验证是否为镜像延迟：运行
curl -I https://mirrors.aliyun.com/composer/p/vendor/package.json，看响应头Last-Modified时间是否接近当前时间 - 临时切回官方源测试：
composer config --unset repos.packagist && composer clear-cache && composer show vendor/package，能查到就确认是镜像滞后 - 不要依赖
composer search判断包是否存在，它查的是 Packagist 主站快照；真正装得上装不上，得看composer show或composer require时的实际元数据加载结果
minimum-stability 是最隐蔽的“搜得到却装不上”原因
项目默认 "minimum-stability": "stable"，哪怕 composer search 显示出了 vendor/package:v2.0.x-dev，composer require vendor/package 也会直接报 Could not find package，而不是提示“版本不稳定”。
- 检查当前稳定性设置：
composer config minimum-stability - 临时放宽限制安装：
composer require vendor/package --stability=dev --no-update - 注意：全局设
"minimum-stability": "dev"风险很大，容易拉入大量不稳定依赖，建议仅对单个包用--stability参数 - 更稳妥的做法是查清目标包是否有 stable 版本，或联系作者打正式 tag
真正卡住安装的，往往不是搜索不到，而是 composer require 阶段的约束校验——PHP 版本、扩展缺失、依赖冲突、镜像延迟、源未生效，这些全发生在搜索之后。别盯着 search 结果反复试，先跑 composer why-not vendor/package 或 composer prohibits vendor/package，输出里哪一行带 requires 或 php version，就是真拦路虎。
