全文搜索

📅 2026-11-21 👁️ 0

全文搜索

全文搜索用于让前台搜索覆盖文档正文、分类和标签,而不只是标题。页面本体是一个带条件联动的多项配置表单,开启后需选定引擎并配置索引范围。

入口路径

后台顶部菜单 →「功能」→「系统功能」→「全文搜索」。实际地址:/system/plugin/system/fulltext,需要管理员权限(canAdmin)。

功能说明

页面由三部分组成:

  • 顶部提示区:说明当前索引数量、重建索引入口与分词词典配置方法。
  • 配置表单:开关、引擎、数值参数、索引内容、模型与搜索类型,后四项仅在「开启」后出现,引擎相关字段仅在引擎非内置时出现。
  • 重建索引:开启后系统会建立索引,可手动触发全量重建。

界面截图

关闭态(只有开关):

全文搜索关闭态

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

全文搜索展开态

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

全文搜索 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},即始终开启、不可关闭 [源码+实测];「分类搜索」「标签搜索」可自由勾选,默认未勾选 [实测]。

选择建议:需要用户按分类名或标签名找到内容时勾选对应项;否则保持默认以减少索引量。

填错后果:关闭分类/标签搜索后,相关页面不会出现在搜索结果中。

操作步骤

  1. 进入「功能 → 系统功能 → 全文搜索」。
  2. 将「是否开启全文搜索」设为「开启」,展开配置项。
  3. 选择搜索引擎;若选外部引擎,填写地址与凭据(内置悟空搜索跳过)。
  4. 按需设置「搜索词包含长度」「搜索词排名分数」「索引内容」「开启的模型」「搜索的类型」。
  5. 点击「提交」保存。
  6. 首次开启或改动引擎/索引范围后,点击顶部提示区的「重建索引」,等待进度完成。
  7. 到前台搜索关键词验证结果。

适用场景与建议

  • 小站 / 内存有限:用内置悟空搜索,索引内容选「仅标题和简介」,搜索词包含长度设 2。
  • 已有 ES 集群 / 大站:选 Elasticsearch,填地址与凭据,索引内容选「包括文档内容」,按需开启分类/标签搜索。
  • 中文分词效果差:编辑站点根目录下的 dictionary.txt 添加业务词条(格式参考 github.com/huichen/wukong 的 dictionary.txt)。

注意事项

  • 内置悟空搜索会占用大量服务器内存,内存不足时建议关闭全文搜索或改用外部引擎。
  • 引擎相关字段仅在引擎非 default 时显示,「用户名」在 Meilisearch 下不显示——切换引擎后注意核对已填内容。
  • 默认值取自源码注释与实测:包含长度 0、排名分数 0、索引内容「仅标题和简介」、三模型全勾选、文档搜索固定开启 [COMPUTED]。
  • 外部引擎的账号密码属敏感信息,不要写进公开文档或截图。
  • 修改配置后前台未生效,先确认是否重建了索引,再清理缓存。

相关文档