首页/数据/NoSQL 速查/IK 中文分词器安装与使用
Elasticsearch89 条

IK 中文分词器安装与使用

IK 是常见的中文分词插件:安装包版本必须与集群版本一致,安装后需重启节点;映射里可分别指定索引期 analyzer 与查询期 search_analyzer。

NoSQL 速查数据更新于 2026-10-12
安装方式bin/elasticsearch-plugin install <插件下载地址或本地路径>
版本要求插件版本号与 Elasticsearch 版本严格一致,否则节点无法启动
常用分析器ik_max_word 拆得细(索引期)、ik_smart 拆得粗(查询期)

安装示例

安装示例
# 下载与集群同版本的插件包后本地安装(8.x 示例,x.y.z 换成实际版本)
bin/elasticsearch-plugin install file:///tmp/elasticsearch-analysis-ik-8.x.y.zip
# 安装完成后重启节点
systemctl restart elasticsearch

映射配置

映射配置
{
  "properties": {
    "title": {
      "type": "text",
      "analyzer": "ik_max_word",
      "search_analyzer": "ik_smart"
    }
  }
}
自定义词典放在 config/analysis-ik/ 目录下,改词典可在不重启集群的情况下热更新。

易错点

  • 插件与 ES 版本不一致是节点起不来的高频原因,升级前先规划插件的同步升级
  • 只改索引期 analyzer 不改查询期(或反之)会造成相同词也搜不到,两侧要一起验证 _analyze

数据来源与参考

  • Elasticsearch 中文分词插件 elasticsearch-analysis-ik(GitHub medcl)
  • Elasticsearch Guide: Analysis
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌