ES默认standard分词器对中文单字切分导致语义丢失，必须安装IK分词器并配置analyzer为ik_max_word或ik_smart，Laravel Scout需在映射中指定字段分析器，重建索引后验证分词效果。
为什么默认 match 查询对中文关键词不敏感
ES 默认的 standard 分词器按空格、标点切分，对中文直接单字切分（如“搜索引擎”→[“搜”, “索”, “引”, “擎”]），导致关键词整体语义丢失。用户搜“搜索引擎优化”，返回结果可能包含“引擎盖”“搜索记录”等无关内容。这不是 Laravel Scout 配置问题，而是底层分词器没适配中文。
必须安装并启用 IK 分词器
不装 IK，所有后续优化都无效。Laravel Scout 本身不干预分词逻辑，它只是把查询原样发给 ES；真正决定“怎么切词”的是索引创建时指定的分词器。
- 在 Elasticsearch 容器中执行：
bin/elasticsearch-plugin install https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v8.12.2/elasticsearch-analysis-ik-8.12.2.zip（版本需与 ES 主版本严格一致） - 重启 ES 后，验证是否生效：
GET /_cat/plugins?v应看到ik - 新建索引时显式指定 analyzer：
"analyzer": "ik_max_word"（全文检索用）或"analyzer": "ik_smart"（精准匹配用）
Laravel Scout 中强制使用 IK 分析器
Scout 默认建索引时不指定 analyzer，会 fallback 到 standard。必须在模型的 toSearchableArray() 或映射配置中控制字段类型。
- 在
config/elasticsearch.php的indices配置里，为对应模型索引定义 mapping： - 例如用户姓名字段：
"name": {"type": "text", "analyzer": "ik_max_word", "search_analyzer": "ik_smart"} - 重建索引前先删旧索引：
php artisan scout:flush "App\Models\User"，再scout:import - 验证分词效果：
GET /users/_analyze?analyzer=ik_max_word&text=全文搜索引擎，应返回 [“全文”, “搜索引擎”, “全文搜索引擎”]
多关键词组合查询时避免 match_phrase 的误用
match_phrase 要求词序+紧邻，看似“更准”，但实际大幅降低召回率。比如用户搜“PHP 开发”，而文档存的是“开发 PHP 框架”，match_phrase 直接不命中。
- 优先用
multi_match+best_fields策略，让多个字段参与打分 - 在 Scout 自定义引擎中覆盖
buildPayload()方法，把原始关键词拆成数组后构造 DSL： "query": {"multi_match": {"query": "PHP 开发", "fields": ["name^3", "bio^2", "title"], "type": "best_fields"}}- 如需保留部分短语语义，可用
bool/must包裹多个match，而非强依赖match_phrase
分词器和 analyzer 是硬依赖项，不装 IK 或不配 mapping，光调 Laravel 代码毫无意义。很多团队卡在“搜不到”，最后发现连分词器都没装——这点最容易被忽略。
