MongoDB本地版不支持$ search，须用$text配合text索引；中文需设default_language:"none"；查询前须标准化大小写、标点、空格；权重为0的字段不参与索引。
search操作符写错或没用对场景
MongoDB 的 $search 是 Atlas Search 专属操作符，**本地部署的 MongoDB 社区版/企业版默认不支持**。如果你在非 Atlas 环境下写了 {$search: {text: "xxx"}}，会直接报错或静默忽略——根本不会命中全文索引。
本地 MongoDB 要做文本搜索，必须用 $text 操作符，且前提是已创建了 text 类型索引（不是 search 索引）。
- ✅ 正确（本地）：
db.posts.find({$text: {$search: "mongodb 教程"}}) - ❌ 错误（本地）：
db.posts.aggregate([{$search: {text: {query: "mongodb", path: "title"}}}])→ 报错unknown operator: $search - ⚠️ 注意：
$text查询必须配合text索引，且不能和$or、$not等组合使用，否则索引失效
default_language 配置导致中文被切碎或跳过
MongoDB 默认 text 索引的 default_language: "english"，它只按空格、标点分词，对中文完全无效——比如存入 “人工智能入门”，索引里实际只存了整个字符串作为一个 token，搜 “智能” 或 “入门” 就查不到。
解决方法是显式指定中文分词器：default_language: "none" 或 "zh"（4.2+ 支持），并配合 language_override 字段控制单文档语言。
- 建索引时加配置：
db.articles.createIndex({title: "text", content: "text"}, {default_language: "none"}) - 这样每个汉字都会被单独索引（类似 n-gram 效果），但要注意：字段值越长，索引体积越大、写入越慢
- 如果混用中英文，建议设为
"none"并自己预处理——比如把中文词组用空格隔开："人工智能 入门 教程"
查询值未经过标准化，大小写/标点/空格不一致
$text 查询默认**区分大小写、保留标点、严格匹配空格**。你存的是 "Node.js 入门"，但搜 "nodejs入门" 或 "NodeJS 入门" 就失败。
MongoDB 不会自动做简体转繁体、全角转半角、去重空格等操作，这些都得在写入前统一处理。
- 入库前建议：转小写、全角标点→半角、连续空格→单空格、去除首尾空白
- 避免依赖索引“智能匹配”：它没有模糊容错，
$text是精确 token 匹配 - 验证分词效果：
db.runCommand({text: {collection: "articles", search: "入门", language: "none"}})看返回的score和匹配位置
text 索引未覆盖查询字段或权重设为 0
创建 text 索引时用了 weights，但把某个字段权重设为 0，等于告诉 MongoDB：“别索引这个字段”。哪怕你查的是该字段，也不会参与匹配。
例如：{weights: {title: 10, content: 0}} → content 字段完全不建倒排索引。
- 检查现有索引：
db.articles.getIndexes()，找key含_fts的项，看weights字段 - 重建索引前先删旧的：
db.articles.dropIndex("title_text_content_text") - 权重只影响排序分值，不影响是否能查到；真正决定“能不能搜到”的，是字段是否出现在
key中且权重 ≠ 0
db.runCommand({text: ...}) 多试几次不同输入，比反复改查询条件更有效。 
