MySQL的中文全文搜索需要适配中文无空格分隔的语言特性，默认的英文全文索引无法正确拆分中文词汇，会导致搜索结果偏差。通过配置n-gram全文索引，可以让MySQL支持中文内容的准确检索，同时结合合理的优化策略，能进一步提升搜索性能。
MySQL中文全文搜索的核心原理
MySQL从5.7版本开始原生支持n-gram全文解析器，n-gram是将文本按固定长度拆分为连续子串的分词方式，比如对中文词语数据库使用2-gram拆分，会得到数据、据库两个子串。这种方式不需要依赖额外的分词插件，就能适配中文的分词需求。
默认情况下，MySQL的全文索引使用ngram_token_size参数控制拆分长度，取值范围是1到10，默认值为2。如果业务场景下的搜索词多为3字或4字短语，可以适当调大这个参数，提升分词的准确性。
中文全文索引的创建与配置
1. 修改MySQL配置
首先需要调整MySQL的配置文件，添加n-gram解析器相关配置，重启服务后生效：
[mysqld] # 开启n-gram全文解析器 ngram_token_size=2 # 可选：调整最小搜索词长度，默认是4，中文场景可以调小到2 ft_min_word_len=2
2. 创建带全文索引的表
创建存储中文内容的表时，需要为需要检索的字段添加全文索引，并指定使用ngram解析器：
-- 创建文章表，存储中文标题和内容
CREATE TABLE article (
id INT PRIMARY KEY AUTO_INCREMENT,
title VARCHAR(200) NOT NULL COMMENT '文章标题',
content TEXT NOT NULL COMMENT '文章内容',
create_time DATETIME DEFAULT CURRENT_TIMESTAMP,
-- 为标题和内容添加联合全文索引，使用ngram解析器
FULLTEXT INDEX idx_fulltext_title_content (title, content) WITH PARSER ngram
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='文章表';
3. 插入测试数据
插入几条中文测试数据，验证索引的生效情况：
INSERT INTO article (title, content) VALUES
('MySQL基础教程', '本文介绍MySQL的安装和基本使用方法，适合新手学习'),
('MySQL中文全文搜索实践', '讲解如何配置MySQL的中文全文搜索，提升中文内容检索效率'),
('数据库优化技巧', '分享常见的数据库查询优化方案，减少慢查询的出现');
中文全文搜索的使用方法
基础搜索语法
使用MATCH...AGAINST语法进行全文搜索，支持自然语言模式和布尔模式两种搜索方式：
-- 自然语言模式搜索，返回相关度评分
SELECT id, title, content,
MATCH(title, content) AGAINST('MySQL中文搜索' IN NATURAL LANGUAGE MODE) AS score
FROM article
WHERE MATCH(title, content) AGAINST('MySQL中文搜索' IN NATURAL LANGUAGE MODE);
上述查询会返回标题或内容中包含MySQL、中文、搜索相关子串的记录，同时给出相关度评分，评分越高说明匹配度越高。
布尔模式搜索
如果需要更精准的搜索控制，可以使用布尔模式，支持+（必须包含）、-（必须排除）、*（通配符）等运算符：
-- 搜索必须包含MySQL，且包含中文，不包含优化的记录
SELECT id, title, content
FROM article
WHERE MATCH(title, content) AGAINST('+MySQL +中文 -优化' IN BOOLEAN MODE);
性能优化实践
1. 合理设置ngram_token_size
如果业务中的搜索词大多为2字词语，保持ngram_token_size为2即可；如果搜索词多为3字或4字短语，可以将其调整为3或4，减少无用的子串拆分，提升索引效率和查询速度。修改后需要重建全文索引才能生效：
-- 删除原有全文索引 DROP INDEX idx_fulltext_title_content ON article; -- 重建全文索引，使用新的ngram配置 CREATE FULLTEXT INDEX idx_fulltext_title_content (title, content) WITH PARSER ngram;
2. 限制搜索返回结果数量
全文搜索如果不加限制，可能会返回大量低匹配度的结果，建议结合LIMIT子句限制返回数量，同时优先展示相关度高的结果：
SELECT id, title, content,
MATCH(title, content) AGAINST('数据库' IN NATURAL LANGUAGE MODE) AS score
FROM article
WHERE MATCH(title, content) AGAINST('数据库' IN NATURAL LANGUAGE MODE)
ORDER BY score DESC
LIMIT 10;
3. 避免过度使用通配符
布尔模式下的*通配符会导致全索引扫描，性能开销较大，非必要场景不要使用。如果必须使用通配符，尽量缩小搜索词的范围，比如使用数据*而不是*数据*。
常见问题与解决方案
- 搜索不到结果：检查ngram_token_size是否小于等于搜索词的长度，同时确认ft_min_word_len参数没有过滤掉短搜索词。
- 搜索结果不准确：可以适当调大ngram_token_size，或者结合业务场景对搜索词做预处理，拆分出更精准的关键词再搜索。
- 查询速度慢：检查全文索引是否生效，是否返回了过多低匹配度的结果，是否有不必要的通配符查询。
注意：MySQL的全文索引适合中等规模的中文内容检索，如果数据量达到千万级以上，建议结合Elasticsearch等专业搜索引擎使用，获得更好的检索性能。
MySQL中文全文搜索n-gram全文索引全文搜索优化中文分词修改时间：2026-07-21 09:24:37