全文搜索
全文搜索
全文搜索用于让前台搜索覆盖文档正文、分类和标签,而不只是标题。页面本体是一个带条件联动的多项配置表单,开启后需选定引擎并配置索引范围。
入口路径
后台顶部菜单 →「功能」→「系统功能」→「全文搜索」。实际地址:/system/plugin/system/fulltext,需要管理员权限(canAdmin)。
功能说明
页面由三部分组成:
- 顶部提示区:说明当前索引数量、重建索引入口与分词词典配置方法。
- 配置表单:开关、引擎、数值参数、索引内容、模型与搜索类型,后四项仅在「开启」后出现,引擎相关字段仅在引擎非内置时出现。
- 重建索引:开启后系统会建立索引,可手动触发全量重建。
界面截图
关闭态(只有开关):

开启后展开的全部配置项:

选择 Elasticsearch 后出现的地址、用户名、密码字段(凭据为虚构占位值):

设置项说明
| 设置项 | 作用 | 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 |
|---|---|---|---|---|
| 是否开启全文搜索 | 总开关,控制是否启用全文索引 | 关闭 / 开启;默认关闭 [源码+实测] | 需要正文搜索才开启;小内存服务器建议关闭或改用外部引擎 | 关闭后前台仅搜索标题和简介;开启后下方配置项才显示 |
| 全文搜索引擎 | 决定用哪种引擎建立索引 | 悟空搜索(内置) default / Elasticsearch / ZincSearch / Meilisearch;源码默认 default [源码],实测四个 radio 无预选中,建议显式选择 |
小站/内存 <2G 用内置悟空;已有 ES 集群或大站选 Elasticsearch;追求轻量可选 ZincSearch 或 Meilisearch | 后三种为 VIP 功能,未开通时不可选;切换引擎后需重建索引 |
| 地址 | 外部引擎的访问地址 | 仅引擎非 default 时显示;无默认 [源码] |
填完整 URL,如 http://127.0.0.1:9200;远程引擎填实际域名或 IP |
地址错误会导致索引失败;内置悟空搜索无此项 |
| 用户名 | 外部引擎的认证账号 | 仅引擎为 Elasticsearch/ZincSearch 时显示;无默认 [源码] | 按引擎实际账号填写 | Meilisearch 无此项;凭据属敏感信息,注意保管 |
| 密码 | 外部引擎的认证密码 | 仅引擎非 default 时显示;无默认 [源码] |
按引擎实际密码填写 | 修改后需重新提交并重建索引 |
| 搜索词包含长度 | 控制搜索词的最小匹配长度 | 整数,默认 0 [源码+实测],无显式上下界 | 中文站建议 2;设为 0 表示短词全包含、长词至少包含 n 个字符 | 设过大导致短词搜不到结果;设 0 时匹配最宽松 |
| 搜索词排名分数 | 过滤低分结果 | 0–100,默认 0 [源码+实测] | 默认 0 显示所有结果;结果太杂时可设 30–50 | 高于该分的结果才显示;设过高会大量漏结果 |
| 索引内容 | 决定索引范围是否含正文 | 仅标题和简介 false(默认 [实测])/ 包括文档内容 true |
需要全文检索选「包括文档内容」;只按标题搜保持默认 | 含正文会显著增加索引体积与内存占用 |
| 开启的模型 | 选择哪些模型的文档进入索引 | 多选:文章模块、产品模块、案例模块;实测三者全勾选 [实测] | 只勾选实际需要搜索的模型,减少索引量 | 未勾选的模型其文档不会被全文搜索命中 |
| 文档搜索 | 索引并搜索文档 | 默认勾选且禁用 [源码+实测] | 无需操作,始终开启 | 由系统固定开启,不可关闭 |
| 分类搜索 | 是否索引并搜索分类 | 未勾选 / 勾选;默认未勾选 [实测] | 需要按分类名搜索时勾选 | 勾选后分类页会进入搜索范围 |
| 标签搜索 | 是否索引并搜索标签 | 未勾选 / 勾选;默认未勾选 [实测] | 需要按标签名搜索时勾选 | 勾选后标签页会进入搜索范围 |
| 重建索引 | 全量重建搜索引擎索引 | 按钮,点击后弹确认框 [源码] | 首次开启、切换引擎、改索引内容或模型后执行 | 重建期间有进度提示,数据量大会耗时;执行中前台搜索结果可能不完整 |
配置项详解
全文搜索引擎
出现条件:仅在「是否开启全文搜索」为「开启」时显示 [源码]。
四种引擎的含义与选择:
| 引擎值 | 名称 | 适用 | 限制 |
|---|---|---|---|
default |
悟空搜索(内置) | 小站、无外部搜索服务 | 占用服务器内存较大;需手工维护 dictionary.txt 分词词典 |
elasticsearch |
Elasticsearch | 已有 ES 集群、大站 | VIP 功能;需填地址、用户名、密码 |
zincsearch |
ZincSearch | 轻量替代 ES | VIP 功能;需填地址、用户名、密码 |
meilisearch |
Meilisearch | 轻量、易用 | VIP 功能;需填地址、密码,无用户名 [源码] |
VIP 限制:源码中 engine 单选在 isVip === false 时禁用,非 VIP 用户点击会弹出开通提示。实测本环境四种选项均可见 [COMPUTED]。
联动:引擎非 default 时才显示「地址」「用户名」「密码」;meilisearch 不显示「用户名」(engine !== 'meilisearch' 判断)[源码]。
填错后果:引擎地址或凭据错误会导致索引建立失败、前台搜索无结果。切换引擎后必须重建索引。
搜索词包含长度
出现条件:开启全文搜索后显示 [源码]。
源码注释与界面提示:搜索词包含的最小长度,默认 0;搜索词长度低于 x 个则搜索结果需要全包含,高于 x 个则至少包含 x 个字符 [源码+i18n]。
推荐值:中文站设 2–3;设为 0 时匹配规则最宽松,短词也能命中但结果可能偏多。
填错后果:设得过大(如 10)会让常见短查询完全搜不到结果。
搜索词排名分数
出现条件:开启全文搜索后显示 [源码]。
源码注释:可设置评分 0–100 分,默认 0 分,高于这个评分的结果才显示 [源码+i18n]。
推荐值:默认 0 显示所有结果;若搜索结果过于杂乱,逐步上调到 30–50 观察效果。
填错后果:设为 100 会过滤掉几乎所有结果;设为负数或小数不符合取值范围。
索引内容
出现条件:开启全文搜索后显示 [源码]。
两个取值的含义:
- 仅标题和简介(
false,默认 [实测]):索引体积小、内存占用低,但搜索不到正文里的内容。 - 包括文档内容(
true):可全文检索正文,但索引体积和内存占用显著增加。
选择建议:内容型站点(文章、资料库)选「包括文档内容」;产品展示站只按名称搜索时保持默认。
填错后果:改为「包括文档内容」后如果不重建索引,正文内容不会被检索到。
搜索的类型
出现条件:开启全文搜索后显示 [源码]。
三个复选框中「文档搜索」被源码设为 disabled 且 initialValue={true},即始终开启、不可关闭 [源码+实测];「分类搜索」「标签搜索」可自由勾选,默认未勾选 [实测]。
选择建议:需要用户按分类名或标签名找到内容时勾选对应项;否则保持默认以减少索引量。
填错后果:关闭分类/标签搜索后,相关页面不会出现在搜索结果中。
操作步骤
- 进入「功能 → 系统功能 → 全文搜索」。
- 将「是否开启全文搜索」设为「开启」,展开配置项。
- 选择搜索引擎;若选外部引擎,填写地址与凭据(内置悟空搜索跳过)。
- 按需设置「搜索词包含长度」「搜索词排名分数」「索引内容」「开启的模型」「搜索的类型」。
- 点击「提交」保存。
- 首次开启或改动引擎/索引范围后,点击顶部提示区的「重建索引」,等待进度完成。
- 到前台搜索关键词验证结果。
适用场景与建议
- 小站 / 内存有限:用内置悟空搜索,索引内容选「仅标题和简介」,搜索词包含长度设 2。
- 已有 ES 集群 / 大站:选 Elasticsearch,填地址与凭据,索引内容选「包括文档内容」,按需开启分类/标签搜索。
- 中文分词效果差:编辑站点根目录下的
dictionary.txt添加业务词条(格式参考github.com/huichen/wukong的 dictionary.txt)。
注意事项
- 内置悟空搜索会占用大量服务器内存,内存不足时建议关闭全文搜索或改用外部引擎。
- 引擎相关字段仅在引擎非
default时显示,「用户名」在 Meilisearch 下不显示——切换引擎后注意核对已填内容。 - 默认值取自源码注释与实测:包含长度 0、排名分数 0、索引内容「仅标题和简介」、三模型全勾选、文档搜索固定开启 [COMPUTED]。
- 外部引擎的账号密码属敏感信息,不要写进公开文档或截图。
- 修改配置后前台未生效,先确认是否重建了索引,再清理缓存。