nicolaslopezj/searchable 不兼容 Laravel 10+ 和 PHP 7.4，需按版本选 v4.0.0（Laravel 8/9+PHP8）或 v3.7.0（PHP7.4），且须显式配置 $searchable 字段、避免非文本类型，并正确调用静态 search() 方法。
直接装不上？先确认 Laravel 版本和 PHP 版本是否匹配
nicolaslopezj/searchable 已停止维护，最新稳定版 v4.0.0 只支持 Laravel ^8.0 或 ^9.0，且要求 PHP ^8.0。如果你用的是 Laravel 10+ 或 PHP 7.4，composer require nicolaslopezj/searchable 会报依赖冲突或直接失败。
- 查当前版本：
php -v和php artisan --version - Laravel 10 用户别硬装——它不兼容，强行加
--with-all-dependencies可能破坏其他包 - PHP 7.4 用户必须降级到
v3.7.0（最后支持 PHP 7.4 的版本），命令是：composer require nicolaslopezj/searchable:^3.7
装完模型里加 Searchable trait 却搜不出结果？字段没配对
这个 trait 不是“开箱即搜”，它默认只搜索模型的 $fillable 字段，且要求字段在数据库里是文本型（VARCHAR、TEXT）。如果字段是 JSON、ENUM 或被设为 $guarded，就直接跳过。
- 显式声明要搜的字段：在模型里加
protected $searchable = ['title', 'content']; - 避免用
id或created_at这类非文本字段——即使写了也会被忽略 - MySQL 全文索引不是自动建的，
searchable用的是LIKE %...%，大数据量下慢且不走索引；真要性能，得自己加FULLTEXT索引再改查询逻辑
搜索时返回空数组，但数据明明存在？注意 search() 的调用方式
search() 是静态方法，不是实例方法，也不能链在 where() 后面。写成 Post::where('status', 1)->search('xxx') 会静默失败（返回空集合），因为底层用了 newQuery() 重开了查询。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 正确写法只有两种：
Post::search('xxx')->get()或Post::search('xxx')->paginate() - 想加其他条件？只能合并进搜索关键词，比如
Post::search('xxx status:published')->get()——前提是自己实现了字段前缀解析（原包不带） - 关键词含空格会被拆成
AND模式（'laravel tutorial'→ 匹配同时含两个词的记录），不支持引号精确匹配
升级 Laravel 10 或换新项目？别碰这个包了
作者 2022 年底已归档仓库，GitHub 上 issue 堆积未处理，Laravel 10 的 Builder 方法签名变动导致 search() 内部调用 when() 出错。现在更靠谱的替代方案是手写 whereRaw + CONCAT，或用 Scout 配 Algolia/Meilisearch——但后者要额外服务。
如果只是小项目临时需要，最稳的做法是复制它的核心逻辑（十几行 where 拼接）到本地 scope 里，去掉 trait 依赖，反而更可控。
