IK 分词器默认的词库是通用的但每个项目都有自己的专有名词——小红书里显眼包“多巴胺穿搭”电商里充氮气独立包装——这些词 IK 默认会把它们切成一堆碎词搜索体验很差。这篇文章覆盖 IK 分词器的四种自定义配置扩展词词典让 IK 认识你的专有名词、停用词词典过滤掉无意义的词、MySQL 热更新词典改词库不用重启 ES、同义词词典搜笔记本也召回笔记本电脑。为什么默认词库不够用默认分词多巴胺穿搭 → [多巴胺, 穿搭] ← 能分出来 显眼包 → [显, 眼, 包] ← 拆碎了搜显眼包召回不准 充氮气独立包装 → [充, 氮气, 独立, 包装] ← 充氮气应该是一个词专有名词被拆碎了之后倒排索引里没有完整的 term搜显眼包召回不到。需要让 IK 知道显眼包’是一个完整的词别拆。找到 IK 配置目录Docker 部署的 ESIK 配置路径在/usr/share/elasticsearch/plugins/ik/config/ ├── IKAnalyzer.cfg.xml ← 主配置文件所有词典入口 ├── main.dic ← IK 自带扩展词库 ├── stopword.dic ← IK 自带停用词库 └── ...拼音、繁体等可选模块建议把目录挂出来方便改dockerrun-d\--namees\-p9200:9200\-v./es-plugins/ik:/usr/share/elasticsearch/plugins/ik\elasticsearch:8.15.0改完重启容器生效。下面所有的.dic文件都放在这个config/目录下和IKAnalyzer.cfg.xml同级。完整配置一览先把IKAnalyzer.cfg.xml的最终形态放这里——四种词典的入口都在这一处。后面每个小节分别讲对应文件怎么写。?xml version1.0 encodingUTF-8?!DOCTYPEpropertiesSYSTEMhttp://java.sun.com/dtd/properties.dtdpropertiescommentIK Analyzer 扩展配置/comment!-- 扩展词词典本地文件改完重启 ES --entrykeyext_dictmy_ext.dic/entry!-- 停用词词典本地文件改完重启 ES --entrykeyext_stopwordsmy_stop.dic/entry!-- 扩展词热更新MySQL不重启 --entrykeyremote_ext_dictjdbc:mysql://host.docker.internal:3306/ik?useSSLfalseamp;serverTimezoneAsia/Shanghai/entryentrykeyremote_ext_dict_tableik_ext_dict/entryentrykeyremote_ext_dict_columnword/entry!-- 停用词热更新MySQL不重启 --entrykeyremote_ext_stopwordsjdbc:mysql://host.docker.internal:3306/ik?useSSLfalseamp;serverTimezoneAsia/Shanghai/entryentrykeyremote_ext_stopwords_tableik_stop_dict/entryentrykeyremote_ext_stopwords_columnword/entry!-- 统一刷新间隔秒 --entrykeyremote_ext_dict_interval60/entry/propertiesentry干什么更新方式ext_dict扩展词专有名词改.dic文件 → 重启 ESext_stopwords停用词无意义词改.dic文件 → 重启 ESremote_ext_dict扩展词热更新改 MySQL → 等 60s 自动生效remote_ext_stopwords停用词热更新改 MySQL → 等 60s 自动生效remote_ext_dict_interval刷新间隔默认 60 秒1 扩展词词典——让 IK 认识你的专有名词在config/下新建my_ext.dic一行一个词# my_ext.dic 显眼包 多巴胺穿搭 充氮气 程一口 独立包装重启 ES 后验证curl-XPOSThttp://localhost:9200/_analyze\-HContent-Type: application/json\-d{ analyzer: ik_max_word, text: 充氮气独立包装 }# 返回[充氮气, 独立, 包装]# 充氮气 被保留成完整词了 ✅2 停用词词典——过滤掉无意义的词在config/下新建my_stop.dic# my_stop.dic 的 了 是 在 和 也 就 都 吗 呢 吧重启 ES 后验证curl-XPOSThttp://localhost:9200/_analyze\-HContent-Type: application/json\-d{ analyzer: ik_max_word, text: 今天天气太热了 }# 了 被过滤掉了 ✅3 MySQL 热更新——改词库不用重启 ES重启一次几分钟词库经常变的话吃不消。IK 1.10.0 支持 MySQL 热更新启动时加载之后每隔 60 秒去查一次有新词自动加载到内存。建表CREATEDATABASEik;USEik;-- 扩展词表CREATETABLEik_ext_dict(idBIGINTAUTO_INCREMENTPRIMARYKEY,wordVARCHAR(255)NOTNULLCOMMENT扩展词,create_timeDATETIMEDEFAULTCURRENT_TIMESTAMP);INSERTINTOik_ext_dict(word)VALUES(显眼包),(多巴胺穿搭),(程一口);-- 停用词表CREATETABLEik_stop_dict(idBIGINTAUTO_INCREMENTPRIMARYKEY,wordVARCHAR(255)NOTNULLCOMMENT停用词,create_timeDATETIMEDEFAULTCURRENT_TIMESTAMP);INSERTINTOik_stop_dict(word)VALUES(的),(了),(呢),(吧);放 MySQL 驱动# 下载 mysql-connector-j放到 plugins/ik/ 目录下和 IK 的 jar 同级cpmysql-connector-j-9.2.0.jar ./es-plugins/ik/配置项说明配置含义remote_ext_dictJDBC 连接串用户名密码用userrootpasswordxxx拼在 URL 里remote_ext_dict_table扩展词表名remote_ext_dict_column扩展词所在的列名remote_ext_stopwords停用词 JDBC 连接串remote_ext_stopwords_table停用词表名remote_ext_stopwords_column停用词所在的列名remote_ext_dict_interval刷新间隔秒用户名密码写 JDBC URL 里jdbc:mysql://host:3306/ik?userrootpassword123456useSSLfalse重启 ES 后往 MySQL INSERT 一条新词等 60 秒验证INSERT INTO ik_ext_dict(word)VALUES(新测试词);# 等 60 秒后curl-XPOSThttp://localhost:9200/_analyze\-HContent-Type: application/json\-d{ analyzer: ik_max_word, text: 新测试词在这里 }# 新测试词 被完整保留 → 热更新生效 ✅4 同义词词典——搜笔记本也召回笔记本电脑同义词不归 IK 管属于 ES 的synonymtoken filter。新建同义词文件synonyms.txt放在 ES 的config/目录下/usr/share/elasticsearch/config/不是 IK 的 config一行一组笔记本, 笔记本电脑, laptop 显眼包, 显眼, 显眼精 充氮气, 氮气填充创建 Index 时配上同义词 filterPUT/articles{settings:{analysis:{filter:{my_synonym_filter:{type:synonym,synonyms_path:analysis/synonyms.txt}},analyzer:{ik_synonym_smart:{tokenizer:ik_smart,filter:[my_synonym_filter]},ik_synonym_max_word:{type:custom,tokenizer:ik_max_word,filter:[my_synonym_filter]}}}},mappings:{properties:{content:{type:text,analyzer:ik_synonym}}}}搜笔记本时ES 自动把笔记本电脑也加入查询多种说法都能召回。同义词文件更新后新写入的数据立即生效已有数据需要 reindex 重建索引。
