03.安装Hexo博客搜索插件

清夏晚风 Lv7

步骤 1:安装搜索插件

Redefine 主题使用的是本地搜索(local search),需要安装 hexo-generator-searchdb 插件:

1
npm install hexo-generator-searchdb

步骤 2:在根目录 _config.yml 中添加搜索配置

c:\Users\Yui\Desktop\QXWF-Blog_config.yml 中,添加以下内容(可以在末尾添加):

1
2
3
4
5
6
# Search
search:
path: search.xml
field: post
content: true
format: html

参数说明:

  • path:生成的搜索数据文件路径
  • field:搜索范围,post 表示仅搜索文章,可选 page(页面)或 all(全部)
  • content:是否包含文章全文内容
  • format:数据格式

步骤 3:启用主题搜索功能

需要创建或编辑主题配置文件。推荐在根目录创建 _config.redefine.yml(这样更新主题时配置不会丢失),在其中添加:

1
2
3
4
navbar:
search:
enable: true
preload: true

preload: true 表示页面加载时预加载搜索数据,搜索时响应更快。

完成效果

操作完成后:

  1. 导航栏会出现一个搜索图标(放大镜)
  2. 点击后会弹出搜索弹窗
  3. 支持实时搜索文章标题和内容

执行 hexo clean && hexo generate 重新生成后即可看到效果。

  • Title: 03.安装Hexo博客搜索插件
  • Author: 清夏晚风
  • Created at : 2026-05-26 22:09:53
  • Updated at : 2026-05-29 14:43:35
  • Link: https://blog.yuil.cn/2026/05/26/博客系统相关/Hexo/03.安装Hexo博客搜索插件/
  • License: This work is licensed under CC BY-NC-SA 4.0.
Comments