es高亮字段是安全的html片段，应直接用{!! !!}渲染；需显式指定字段名、确保text类型、避免php二次处理，并在blade中区分使用highlight与_source。
ES 返回的高亮字段是安全的、已结构化处理过的 HTML 片段，**直接用 {!! $highlightedText !!} 渲染即可，无需二次正则替换或 DOM 解析**。但前提是后端必须正确配置 highlight 参数，且前端不误用 {{ }} 转义输出。
highlight 配置必须显式指定字段，不能只写 "*"
很多 Laravel 项目在构建 DSL 时写 "fields" => ["*" => new Highlighter()]，这在旧版 ES（6.x）可能生效，但在 7.0+（包括当前主流 8.x）会静默失效——ES 不再支持通配符字段高亮，"*" 不会被识别，最终返回空 highlight 字段。
- 必须列出具体要高亮的字段名，例如
"fields" => ["title" => new \Elasticsearch\Serializers\SmartSerializer(), "content" => []] - 如果字段是嵌套的（如
user.name），需写成"user.name"，不能省略路径 - 字段名必须与 mapping 中定义的完全一致（区分大小写），否则高亮不触发
- 若字段类型不是
text（比如是keyword），高亮会失败，因为 keyword 不参与分词匹配
PHP 层不要对 ES 返回的高亮结果再做 preg_replace
ES 的 highlight 字段内容已是带 <em></em> 标签的 HTML，且已自动处理了转义、边界、重复匹配等问题。你在 Laravel 控制器里再用 preg_replace 去“加强”高亮，反而会破坏结构：
- 可能把已高亮的
<em>php</em>又包一层，变成<em><em>php</em></em> - 若原始文本含 HTML 标签（如富文本正文），正则跨标签匹配会导致闭合错乱，渲染异常
- ES 默认用
<em></em>，你硬改成<span class="hl"></span>但没同步改 CSS，前端就看不到效果 - 性能上无意义：ES 内部用 Fast Vector 高亮器，比 PHP 正则快一个数量级
Blade 模板中必须用 {!! $hit['_source']['title'] !!} 和 {!! $hit['highlight']['title'][0] !!} 区分使用
ES 返回结果中，_source 是原始字段值，highlight 是加工后的带标签片段。两者语义不同，不能混用：
- 当
highlight存在且非空（isset($hit['highlight']['title'][0])），优先渲染它：{!! $hit['highlight']['title'][0] !!} - 当查询未命中该字段（比如用户搜的是 content，但 title 没匹配），
highlight['title']不存在，此时 fallback 到_source：{{ $hit['_source']['title'] }}（注意这里用{{ }}，防 XSS） - 千万别把
$hit['_source']['title']丢给{!! !!}—— 若字段来自用户输入且未清洗，XSS 风险立刻触发 - 前端 CSS 要提前声明
em { background-color: #fff3cd; padding: 0 2px; }，避免被全局样式覆盖
最容易被忽略的是：ES 高亮默认只返回最多 5 个片段（number_of_fragments），长文本中关键词靠后时可能根本不出现在高亮字段里。真要确保关键词必现，得加 "require_field_match": false 和 "fragment_size": 150，而不是寄希望于前端 JS 补救。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
