MongoDB中文全文搜索需启用collation={"locale":"zh"}索引或Jieba预分词方案；版本须≥4.2，否则collation报错；验证需用db.articles.find({"$text":{"$search":"教程"}})确认分词效果。
要在MongoDB中让含“教程”“部署”“配置”等中文关键词的文档真正被搜到，不能只建个text索引就完事——原生分词器把“Python教程”切为["Python", "教", "程"]，搜“教程”必然失败。
确认MongoDB版本与collation支持
执行 db.version()，确保返回值 ≥ 4.2；低于此版本，【collation={"locale":"zh"}将直接报错】，必须改用预分词方案。
在mongosh中运行 db.runCommand({buildInfo: 1})，检查输出中 versionArray 的前三位是否为 [4,2,0] 或更高。
启用中文collation的全文索引
方法一：单字段基础索引（推荐快速验证）
执行：db.articles.createIndex({"title": "text"}, {collation: {"locale": "zh"}})
方法二：多字段加权索引（生产环境常用）
① 先删除已有text索引：db.articles.dropIndex("title_text")
② 重建带权重和locale的索引：db.articles.createIndex({"title": "text", "content": "text", "tags": "text"}, {weights: {"title": 10, "content": 3, "tags": 5}, collation: {"locale": "zh"}})
注意：【collation与weights不可共存于旧版驱动，若用pymongo 3.x需升级至4.3+】
方法三：指定语言覆盖字段（应对混合语种）
插入测试文档时显式标注语言：db.articles.insertOne({"title": "Docker部署指南", "lang": "zh"})，再建索引：db.articles.createIndex({"title": "text"}, {collation: {"locale": "zh", "strength": 2}})，查询时传入 {"$language": "zh"}。
验证中文分词是否生效
插入一条含典型中文词的文档：db.articles.insertOne({"title": "MongoDB中文全文搜索配置教程"})。
执行查询：db.articles.find({"$text": {"$search": "教程"}})，若返回该文档，说明分词成功；若为空，检查是否遗漏collation或误用了$regex。
进一步验证分词粒度：运行 db.articles.aggregate([{$addFields: {score: {$meta: "textScore"}}}, {$sort: {score: {$meta: "textScore"}}}])，观察“教程”是否作为独立token参与评分——若score极低或为0，说明仍被拆成单字。
替换方案：Jieba预分词 + 数组索引（兼容所有版本）
第一步：用Python处理存量数据
安装jieba：pip install jieba，然后运行：
import jieba<br>from pymongo import MongoClient<br>client = MongoClient()<br>db = client.test<br>for doc in db.articles.find({"title": {"$exists": True, "$type": "string"}}):<br> words = list(jieba.cut(doc["title"]))<br> db.articles.update_one({"_id": doc["_id"]}, {"$set": {"title_tokens": words}})
第二步：为数组字段创建普通索引db.articles.createIndex({"title_tokens": 1}) —— 这步必须做，否则$all查询无加速效果。
第三步：按分词结果查询db.articles.find({"title_tokens": {"$all": ["配置", "教程"]}})，注意：这里不走$text，而是利用MongoDB对数组的$all优化，响应稳定在毫秒级。
