XAMPP中MySQL全文索引搜不到中文短词，根本原因是InnoDB默认innodb_ft_min_token_size=4，需改为1并指定ngram分词器，修改my.ini或my.cnf的[mysqld]段，重启后必须删除并重建全文索引才生效。
为什么XAMPP里全文索引搜不到中文短词
根本原因是 MySQL 默认的 ft_min_word_len（MyISAM）或 innodb_ft_min_token_size（InnoDB）值为 4，意味着“你好”“测试”这类 2 字词直接被过滤掉，压根不进索引。XAMPP 自带的 MySQL 默认用 InnoDB，所以必须改 innodb_ft_min_token_size。
- 该参数控制 ngram 分词器最小切分长度，不是“搜索时最少输几个字”，而是“索引里至少存几个字的词”
- 只对使用
WITH PARSER ngram的全文索引生效；没指定 parser 的默认是英文分词，完全不支持中文 - 修改后必须重建全文索引才生效，重启 MySQL 不够
修改 my.ini 配置文件的具体位置和写法
XAMPP 的 MySQL 配置文件是 xampp\mysql\bin\my.ini（Windows）或 /opt/lampp/etc/my.cnf（Linux/macOS）。别去改 XAMPP 控制面板里显示的“配置 → MySQL”，那个只是快捷入口，实际要编辑文件本身。
- 在
[mysqld]段落下添加两行：innodb_ft_min_token_size = 1ngram_token_size = 1 - 如果已存在
ngram_token_size，确保它和innodb_ft_min_token_size值一致；两者不匹配会导致全文索引创建失败 - 不要加
ft_min_word_len = 1—— 这是 MyISAM 参数，InnoDB 忽略它，加了也没用
重建全文索引才能让新设置起作用
改完配置、重启 MySQL 后，旧的全文索引还是按老规则建的，必须显式删除再重建。光 ALTER TABLE ... DROP INDEX 不够，得用 DROP INDEX + CREATE FULLTEXT INDEX 组合。
- 先查现有全文索引：
SHOW INDEX FROM t_course WHERE Index_type = 'FULLTEXT'; - 删掉它：
DROP INDEX idx_fullname ON t_course; - 重建并指定 parser：
CREATE FULLTEXT INDEX idx_fullname ON t_course(name) WITH PARSER ngram; - 验证是否生效：
SELECT * FROM INFORMATION_SCHEMA.INNODB_FT_CONFIG WHERE KEY = 'minimum_token_size';应返回 1
联合字段全文索引和 JOIN 场景的硬限制
MySQL 全文索引不支持跨表 OR 条件下的索引下推。比如 WHERE MATCH(tc.name) AGAINST(...) OR MATCH(tct.name) AGAINST(...)，即使两个表都建了全文索引，EXPLAIN 也会显示 type: ALL，走全表扫描。
- 单表多字段联合全文索引可行：
CREATE FULLTEXT INDEX idx_multi ON t_course(name, desc) WITH PARSER ngram;，但查询时MATCH()里的字段顺序必须和建索引时一致 - JOIN 场景想用全文检索，只能拆成两次查询，或者把相关字段冗余到一张宽表里建索引
-
ngramparser 对标点、空格、数字混合内容分词效果一般，比如“v1.2.3”可能被切成 “v”, “1”, “2”, “3”，这不是配置问题，是分词器原理决定的
XAMPP 修改全文索引行为的关键不在“启动参数”或“PHP 层设置”，而在于准确识别当前引擎（InnoDB）、改对配置项、重建索引、避开 JOIN 全文的语法陷阱——漏掉任意一环，MATCH...AGAINST 都会静默退化为 LIKE 扫描。
