Relevanssi插件怎么用？

照着做完，你就能把 WordPress 自带的"模糊搜索"换成 Relevanssi，让站内搜索结果按相关性排序、还能搜到自定义字段里的内容。下面以免费版 Relevanssi 4.x 为例，Premium 版界面基本一致，只是多出几个子页面。

第一步：安装并启用插件

这一步的目标是让 Relevanssi 接管 WordPress 的搜索入口。登录 WordPress 后台，左侧菜单点「插件」→「安装插件」，在右上角搜索框输入 Relevanssi，找到作者 Mikko Saari 的那个，点「现在安装」，安装完成后按钮变成「启用」，点一下。

启用后 WordPress 的搜索请求会自动交给 Relevanssi 处理，你不需要改任何模板文件。

第二步：建立索引

Relevanssi 不是实时搜索数据库，而是先把文章内容"抄"一份到自己的索引表里，所以必须先建索引，否则搜索结果永远是空的。

左侧边栏找到「Relevanssi」菜单 →「Dashboard」页面，会看到提示索引未建立，点页面上的「Build the index」按钮，等进度跑完。文章上千篇时这一步可能要几分钟，期间不要关页面。

如果你有服务器命令行权限，用 WP-CLI 更快、还不怕超时：

wp relevanssi index

注意：以后每次修改索引相关设置（比如新加了自定义字段），都要回来重新点一次「Build the index」，否则改动不生效——这是新手最容易踩的坑。

第三步：设置索引范围

这一步决定"哪些内容能被搜到"。进入「Relevanssi」→「Indexing」页面：

• 自定义字段：勾选索引 custom fields，在输入框里填字段名。用 ACF 建的字段，填字段的 name（不带 _ 前缀），多个用英文逗号隔开。
• 分类法：勾选要索引的分类、标签。
• 附件：如果你想让 PDF、Word 文档里的文字也能被搜到，勾选附件相关选项（需要服务器装了相应解析库）。

改完点页面底部的「Save the options」，然后回 Dashboard 重新建索引。

第四步：调整搜索行为

进入「Relevanssi」→「Searching」页面，几个关键项：

• 默认排序：选按相关性（relevance）而不是按日期。
• 多词逻辑：AND 表示结果必须包含全部关键词，OR 表示包含任意一个即可。站内搜索一般用 AND。
• 后台搜索：勾选后，后台文章列表页的搜索框也走 Relevanssi。
• 最小词长：默认 3，中文站点可以设成 1 或 2。

再到「Weight」页面给标题、正文、标签、评论分别设权重。标题权重给到 10 以上、正文保持 1，用户搜品牌词时标题命中的文章就会排前面。

注意：免费版按空格和标点切词，中文整句会被当成一个词，搜索效果差。中文站点要么上 Premium 版开启 CJK 支持，要么改用专门的中文搜索方案。

第五步：控制结果摘要与高亮

「Excerpts」页面控制搜索结果里显示多少字符，默认 30 个词左右，改成 50–80 更利于用户判断。「Highlighting」页面打开高亮，用户搜的词会在摘要里标黄。

前端不需要动模板，主题自带的 search.php 会自动用上这些设置。如果你自己写了搜索模板，把 the_excerpt() 换成 relevanssi_the_excerpt()，把 the_title() 换成 relevanssi_the_title()。

第六步：验证

前台搜索一个只写在自定义字段里、正文没出现过的词。能搜到，说明索引和字段配置都对；搜不到，回到 Indexing 页面确认字段名有没有拼错，然后重建索引。

小结

• 装完必须点「Build the index」，否则搜索无结果
• 每次改索引设置后都要重建索引
• Indexing 页面决定搜什么，Weight 页面决定谁排前面
• 中文站点免费版效果差，需 Premium 或其他方案
• 前端无需改模板，自定义模板时用 relevanssi_ 系列函数