【ES】[其他] ---- Windows 下安装 Elasticsearch 8 分词器详细教程 (ICU国际分词器 + IK中文分词器 + 拼音分词器)
本文详细介绍了在Windows系统上为Elasticsearch 8安装三种常用分词器的步骤: ICU分词器:通过elasticsearch-plugin命令安装官方维护的多语言分词器 IK分词器:需下载对应版本的zip包并解压到plugins/ik目录 拼音分词器:同样需要版本匹配,解压到plugins/pinyin目录 安装完成后需重启Elasticsearch并通过curl命令验证。注意事项
以下是在 Windows 系统上为 Elasticsearch 8 安装 ICU 分词器、IK 分词器和拼音分词器的详细步骤:
准备工作
- 确保已正确安装 Elasticsearch 8.x 并能正常启动
- 记录你的 Elasticsearch 版本号(后续下载对应版本的分词器)
- 确保 Elasticsearch 服务已停止(安装插件前必须停止服务)
安装 ICU 分词器
ICU 分词器是 Elasticsearch 官方维护的插件,支持多语言分词。
- 打开命令提示符(CMD)或 PowerShell
- 进入 Elasticsearch 安装目录的 bin 文件夹:
cd D:\javaAll\elasticsearch-8.0.0\bin - 执行安装命令:
elasticsearch-plugin install analysis-icu - 当出现确认提示时,输入
y并回车 - 等待安装完成,会显示 “Installed analysis-icu”

安装 IK 分词器
IK 分词器是针对中文的分词器,支持自定义词典。
- 首先确定需要安装的 IK 分词器版本,必须与 Elasticsearch 版本完全一致
- 打开浏览器,访问 IK 分词器的 GitHub releases 页面:
https://release.infinilabs.com/analysis-ik/stable/

- 下载对应版本的 zip 包(例如 elasticsearch-analysis-ik-8.0.0.zip)
- 在 Elasticsearch 安装目录中创建 plugins/ik 文件夹:
- 将下载的 zip 包解压到刚创建的 ik 文件夹中
- 确认解压后的文件结构,应直接包含 plugin-descriptor.properties 等文件,而不是嵌套在另一个文件夹中

安装拼音分词器
拼音分词器可以将中文转换为拼音,支持首字母等功能。
-
确定需要安装的拼音分词器版本,必须与 Elasticsearch 版本匹配
-
打开浏览器,访问拼音分词器的 GitHub releases 页面:
https://release.infinilabs.com/analysis-pinyin/stable/
-
下载对应版本的 zip 包(例如 elasticsearch-analysis-pinyin-8.0.0.zip)
-
在 Elasticsearch 安装目录中创建 plugins/pinyin 文件夹:
-
将下载的 zip 包解压到刚创建的 pinyin 文件夹中
-
确认文件结构正确,直接包含插件相关文件

验证安装
-
启动 Elasticsearch 服务:
-
打开另一个命令提示符窗口,使用 curl 验证插件是否安装成功:
在 curl 命令中添加 -k 或 --insecure 参数,跳过证书验证:
curl -k -u elastic:Nf1DPSjkYq6skDNAHY1K "https://localhost:9200/_cat/plugins?v" -
如果安装成功,会显示类似以下内容:

常见问题解决
- 版本不匹配:确保所有分词器版本与 Elasticsearch 版本完全一致
- 权限问题:如果解压文件失败,尝试以管理员身份运行解压软件
- 文件结构错误:插件文件必须直接放在 plugins/[插件名] 目录下,不能有额外的层级
- 启动失败:查看 logs 目录下的日志文件,通常会明确指出错误原因
完成以上步骤后,你就成功在 Windows 系统的 Elasticsearch 8 中安装了 ICU 分词器、IK 分词器和拼音分词器,可以在索引映射中配置使用这些分词器了。
火山引擎开发者社区是火山引擎打造的AI技术生态平台,聚焦Agent与大模型开发,提供豆包系列模型(图像/视频/视觉)、智能分析与会话工具,并配套评测集、动手实验室及行业案例库。社区通过技术沙龙、挑战赛等活动促进开发者成长,新用户可领50万Tokens权益,助力构建智能应用。
更多推荐
所有评论(0)