技能介绍

要解决的问题

WordPress 默认的 WP_Query 基于 MySQL 的 LIKE 匹配，内容库一旦扩大，全文检索的问题会集中爆发：匹配停留在子串层面，结果排序基本取决于发布时间或固定字段，无法按相关度排序，也没有现成的分面筛选能力。对以 WooCommerce 搭建的商品目录来说，筛选维度多、属性组合复杂时，数据库查询成本随类目深度上涨，列表页动辄数百毫秒甚至秒级响应。ElasticPress 要解决的就是这一类问题：把搜索与查询的执行引擎从 MySQL 换成 Elasticsearch。

核心能力与工作方式

ElasticPress 的核心思路是把 WordPress 内容写入 Elasticsearch 索引，在查询阶段拦截 WP_Query，把参数翻译成 Elasticsearch 的查询 DSL，由 ES 完成检索与打分。具体能力包括：

相关度分析：基于 ES 的打分机制对内容排序，替代默认的时间序排序。
分面搜索（faceted search）：支持按分类、标签、自定义字段等维度聚合命中数量，侧栏可以展示各筛选项的计数。
WooCommerce 商品筛选：面向商品目录优化，可组合价格、库存、自定义商品属性进行过滤。
自动补全（autosuggest）：在大规模内容库上提供输入时的即时提示。

关键步骤：插件在内容发布、更新时同步构建并维护索引；查询请求经过其查询钩子改写为 ES 查询；结果回填为标准的 WP_Query 结果对象，因此与主题和插件的兼容路径保持一致。索引与数据的一致性由其同步机制保证，新增或修改的内容会被推送到索引中。

适用边界与注意点

要求 WordPress 6.2 及以上版本。
开发/构建链路需要 Node.js v20 和 npm v9，属于环境前置条件。
从 4.0.0 起，trunk 分支为稳定分支，develop 分支不再包含构建产物；如需可部署的插件包，应从 GitHub Releases 页面获取包含构建产物的 5.2+ 版本 ZIP。
Elasticsearch 服务本身需要独立部署和运维，索引映射调优、集群配置等细节不在技能文档覆盖范围内。

截图预览

使用场景

**内容库检索性能优化**：当 WordPress 站点积累超过万篇内容后，通过 ES 索引重构全文检索路径，降低首页搜索响应延迟，减少数据库子串匹配的负载。
**WooCommerce 商品多维度筛选**：针对商品目录中价格、库存、自定义属性等复合筛选需求，实现分面搜索侧栏的实时命中计数，替代传统多条件 SQL 查询。
**动态内容索引维护**：在频繁更新的新闻或博客站点中，配置发布/更新钩子同步 ES 索引，确保新增内容即时可被检索，避免索引滞后导致的搜索结果不全。
**搜索建议实时补全**：为大型文档库添加输入时即时提示功能，基于 ES 的 term 查询实现前缀匹配，提升用户搜索体验与内容触达效率。