mongodb原生全文搜索不支持中文分词，需手动配置language="none"、预分词或引入第三方方案；仅社区版支持$text操作符，$search为atlas专属。
MongoDB 的全文搜索不是开箱即用的“智能搜索”，它依赖 text 索引和 $text 查询操作符配合，且对中文支持有限——默认分词器不识别中文，必须手动配置分词或改用第三方方案。
如何创建有效的 text 索引
只有带 text 索引的字段才能用 $text 查询。一个集合最多只能有一个 text 索引，但可包含多个字段（加权重）。
常见错误是直接对中文字段建索引却没指定语言：
-
db.collection.createIndex({"title": "text", "content": "text"})—— 对中文基本无效，因默认language: "english" - 正确做法是显式指定
language为"none"（禁用语言规则，按空格/标点切分），或用自定义分词器预处理 - 若字段含中英文混合，建议统一用
language: "none"，否则英文词干提取会干扰中文匹配 - 权重设置影响排序：
{"title": 10, "content": 2}让标题匹配得分更高
Python 中通过 PyMongo 创建：
collection.create_index(
[("title", "text"), ("content", "text")],
default_language="none",
weights={"title": 10, "content": 2}
)
为什么 $search 在 PyMongo 里不能直接用
注意：$search 是 MongoDB Atlas Search 或 4.2+ 企业版的聚合阶段，不是原生 $text 查询的替代品；社区版只支持 $text 操作符。
新手常混淆这两个概念，导致语法报错：
- 写
{"$search": "关键词"}→ 报错unknown operator: $search（社区版不支持） - 正确查询应使用
{"$text": {"$search": "关键词"}} -
$text查询必须走text索引，否则报错text index required - 不支持通配符、正则、模糊匹配；
"python tutorial"默认是 OR 关系，要 AND 得加双引号："\"python\" \"tutorial\""
示例查询：
collection.find(
{"$text": {"$search": "\"mongodb\" \"python\""}},
{"score": {"$meta": "textScore"}}
).sort([("score", {"$meta": "textScore"})])
中文搜索失效的三个关键原因和应对方式
绝大多数“搜不到中文”问题出在底层机制上，不是代码写错。
- MongoDB 原生
text索引不内建中文分词 —— 它把整个中文字符串当一个 token，除非你输入完全一致的字串，否则无法命中 - 即使设了
default_language="none"，仍需字段值本身含空格分隔（如"机器 学习 入门"），否则还是单 token - 更可靠的做法：写入前用
jieba分词，存成数组字段，再对数组建text索引：{"tags": ["机器", "学习", "入门"]} - 或者放弃原生全文搜索，改用 Elasticsearch / Meilisearch 同步数据，MongoDB 只做主存储
性能与排序的隐含代价
$text 查询看似简单，但实际有隐藏成本：
- 每次查询都触发全文扫描 + 相关性打分，无法用普通 B-tree 索引加速，大数据量下明显变慢
-
{"$meta": "textScore"}必须显式请求，否则返回结果无相关性分数 - 排序必须基于
textScore，不能混用其他字段排序（如created_at），否则索引失效 - 不支持分页优化：用
skip/limit做深分页时，MongoDB 仍需计算全部匹配项的 score
如果业务需要高精度中文搜索、高并发或复杂条件组合，原生 $text 只适合小规模、低频场景。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
