Pagefind 是什么

Pagefind 是一个面向静态网站的全文搜索工具。它不要求你维护搜索服务器，也不要求在构建 Markdown 时生成索引，而是在站点 HTML 已经输出之后再运行。

典型流程如下：

Markdown / CMS / 数据源
        ↓
静态站点生成器输出 HTML
        ↓
Pagefind 扫描输出目录并生成 /pagefind/
        ↓
浏览器加载搜索包并完成查询

Pagefind 的核心价值是把搜索功能变成静态资产的一部分。只要你的托管平台能分发 HTML、CSS、JavaScript 和二进制索引文件，就可以运行搜索。

它解决的问题

很多静态站点一开始会使用浏览器内置搜索、第三方托管搜索或自己写 JSON 索引。页面数量变多后，这些方案会遇到几个问题：

• 全量 JSON 太大，首屏加载变慢。
• 自写分词和排名容易变得粗糙。
• 第三方搜索需要额外服务、爬虫或密钥。
• 构建系统里手写索引逻辑会越来越难维护。

Pagefind 会把索引拆成按需加载的静态文件，搜索时只加载必要的数据。结果详情也通过每条结果的 data() 方法按需取回，适合文档类站点的交互模式。

适用边界

Pagefind 适合：

• 页面主要由静态 HTML 组成。
• 搜索目标是站内文档、教程、博客或帮助中心。
• 构建流程可以在部署前运行一个额外命令。
• 搜索结果不需要按用户权限实时变化。

Pagefind 不适合：

• 需要搜索用户私有数据。
• 搜索索引必须实时反映数据库变化。
• 需要复杂业务排序、拼写纠错、同义词系统或向量召回。
• 站点内容主要由登录后的客户端接口动态渲染。

如果你的网站是公开内容站，Pagefind 通常是一个轻量、稳定、上线成本低的选择。