Atlas Search 是 MongoDB 官方全文搜索功能，支持模糊匹配、高亮等；启用需在索引定义中显式配置 highlight 字段，模糊查询用 fuzzy 操作符，高亮内容位于 highlight 子对象中，须显式提取。
Atlas Search 是 MongoDB 官方提供的全文搜索能力，它原生支持模糊匹配、分词、同义词、高亮等高级搜索功能；但注意：传统 find({ field: { $regex: "..." } }) 不支持高亮，也无法利用倒排索引加速，性能差且无法做相关性排序 —— 真正要实现「模糊 + 高亮」，必须用 Atlas Search。
如何启用 Atlas Search 并创建支持高亮的索引
Atlas Search 的高亮依赖于显式定义的 highlight 字段配置，不是默认开启的。你得在创建搜索索引时主动声明哪些字段需要高亮：
- 进入 Atlas 控制台 → 选择项目和集群 → 进入「Search」→ 「Create Search Index」
- 选择目标集合，使用 JSON 模式编辑器（非可视化向导），确保 index definition 中包含
highlight配置项 - 字段类型必须设为
"type": "string"，且不能是"type": "stringArray"或嵌套对象路径（除非你显式展开） - 示例最小可用索引定义：
{
"mappings": {
"dynamic": false,
"fields": {
"title": {
"type": "string",
"analyzer": "lucene.standard"
},
"content": {
"type": "string",
"analyzer": "lucene.standard"
}
}
},
"highlight": {
"fields": ["title", "content"]
}
}
⚠️ 常见错误：漏写 highlight 对象，或字段名拼错（比如写成 "Title" 而实际字段是 "title"），会导致后续查询返回空 highlight 字段。
模糊查询怎么写：用 autocomplete 还是 fuzzy？
两者用途不同，选错会查不到结果：
-
autocomplete专用于「搜索即输入」场景（如地址栏联想），只匹配前缀，不支持中间模糊或后缀。它要求字段在索引中配置"type": "autocomplete"，且建索引时需用lucene.autocompleteanalyzer - 真正意义上的模糊匹配（允许错字、漏字、换序）要用
fuzzy查询操作符，配合标准string字段和lucene.standardanalyzer - 模糊程度由
maxEdits控制（默认 1，最大 2），prefixLength可保留前 N 个字符不参与模糊（防过度匹配）
示例查询（在 mongosh 或 Atlas Search Playground 中运行）：
db.collection.aggregate([
{
"$search": {
"index": "default",
"fuzzy": {
"path": "title",
"query": "monogdb",
"maxEdits": 2,
"prefixLength": 1
}
}
}
])
高亮字段怎么取出来：别直接读 document.title
Atlas Search 返回的结果里，原始文档字段（如 title）不会被自动替换为高亮文本；高亮内容单独放在 highlight 字段下，结构是嵌套的：
{
"_id": "...",
"title": "MongoDB Atlas Search Guide",
"highlight": {
"title": ["<em>MongoDB</em> Atlas Search Guide"]
}
}
- 后端代码中必须显式提取
doc.highlight?.title?.[0]（注意可选链和数组索引），而不是渲染doc.title - 如果字段未命中（比如模糊没匹配到该字段），
highlight.title会是undefined，此时应 fallback 到原始值 - 前端渲染时，
<em></em>标签默认生效，但若用了 CSP 策略或 SSR 框架，需确保 HTML 被正确解析（比如 React 用dangerouslySetInnerHTML）
为什么本地测试总失败？检查这三处
很多人在本地用 mongosh 测试时发现 $search 报错 "Search is not enabled for this collection" 或高亮为空，根源通常在这几个地方：
- 集群版本低于 6.0（Atlas Search 要求最低 6.0，推荐 7.0+）；检查
db.version() - 索引状态不是
READY：新建索引后需等待几分钟，可在 Atlas 控制台「Search Indexes」页看状态列 - 查询时没指定
index名称：即使只有一个索引，也必须显式传"index": "default"，否则默认用旧版text索引（不支持高亮）
最省事的验证方式：直接进 Atlas Search Playground，它自带 sample data 和 ready-to-use index，跳过所有部署环节。
