Blockstudio 与无头 WordPress
一个系统集文件与静态 HTML 于一体,启用后即可使用。
无头 WordPress 会把 WordPress 变成独立前端背后的内容 API,例如 Next.js 读取 REST API,或 Next.js 使用 Faust.js 读取 WPGraphQL。你可以获得 React 生态系统,并完全控制每个区块的标记;但为此需要运行两个系统。Blockstudio 则让一个 WordPress 保持完整:模板存放在文件中,由插件负责渲染,并可按需静态预渲染,以便存储 HTML。
第二套系统的代价
这些事项都有让无头架构正常运作所需的工具文档说明。它们都不是故障,但都需要投入工作。
在 React 中重建区块
Faust.js 使用 React 组件渲染映射的区块,并提供 12 个核心区块作为参考;未映射的区块会以 HTML 形式呈现,不包含其脚本。
预览需要额外配置
Faust 预览需要身份验证、预览路由,以及与 WordPress 共用的密钥。
插件需要扩展
WPGraphQL 列出 ACF、WooCommerce、SEO 和表单插件,说明它们需要扩展或自定义代码。
内容更新需要一套流程
你需要配置 WordPress 调用 revalidatePath,页面会在下次访问时重新生成。CDN 副本需要单独清除缓存。
一个 WordPress,依然静态
启用静态预渲染后,Blockstudio 会存储访客看到的 HTML 匿名版本;保存文章时会清除该文章副本和首页的缓存,启用预热后则会重新渲染这些页面;启用提前提供后,会在 WordPress 启动前发送存储的页面。无论采用哪种配置,前置的 CDN 都仍需单独清除缓存。
插件会在同一批页面上渲染,预览是 WordPress 预览,区块编辑器显示的模板就是访客看到的模板。启用预渲染后,请在 dynamicPaths 中列出插件的动态路径,例如结账和账户页面,这些路径会跳过已存储副本。无需二次构建、第二台主机,也不用配置重新验证钩子。
无头架构更合适的情况
当你的前端是一个应用时:需要大量客户端状态、与其他产品共享的 React 组件,或由一个内容 API 为网站、移动应用和其他客户端供稿。REST API 和 WPGraphQL 正是为此而存在,Faust.js 则让你能在 React 中覆盖任意区块的标记。
Blockstudio 也有局限。页面由 PHP、Twig 或 Blade 模板渲染,而不是 React;静态预渲染默认关闭,需由 blockstudio.json 启用。
并排对比
相同内容放在 WordPress 中,前端由一个还是两个系统构成。
无头架构常见问题
拆分 WordPress 前需要考虑的问题。
无头架构更快吗?
两种方式都能向访客提供存储的 HTML。Next.js 的静态页面和 ISR 页面带有缓存标头,CDN 可将其缓存在边缘;启用静态预渲染后,Blockstudio 会从你的 WordPress 主机提供已存储页面,若启用了提前提供,则会在 WordPress 启动前发送。两者的区别在于,生成这些 HTML 需要运行多少个系统。
Faust.js 目前是什么状态?
它仍在维护中:其软件包于 10 月 7 日发布了版本,2026。它面向 Next.js Pages Router,使用 Apollo Client 3,并提供预览、身份验证、模板层级和区块渲染功能。维护者在 2025 年 1 月宣布停止其 App Router 实验时表示,WP Engine 的 Headless WordPress Toolkit 将取代 Faust。
我的插件在无头架构下还能用吗?
它们的管理界面和数据仍然可用,但前端输出无法沿用:WPGraphQL 为 ACF、WooCommerce、SEO 和表单分别提供了扩展文档;而 WooGraphQL 推荐的结账流程会将会话交还给 WordPress 自己的结账页面。
什么情况下无头架构更合适?
当前端是一个 React 应用、一个内容 API 要为多个客户端供稿,或你希望在 React 中控制每个区块的标记时。如果你的网站供客户编辑并通过插件扩展,那么采用带有 Blockstudio 的单一 WordPress,需要维护的东西更少。
我完全不能在 Blockstudio 中使用 React 吗?
在编辑器中可以:RichText、InnerBlocks 和 MediaPlaceholder 是 React 组件,Blockstudio 会从模板标签中替换成这些组件;script.js 也可以导入 npm 软件包来实现前端行为。页面本身则由 PHP、Twig 或 Blade 渲染。
只保留一个 WordPress
将模板写成文件,启用静态预渲染,让插件、预览和编辑器继续按原有方式工作。
来源,已选中
- WordPress REST API 手册
- WPGraphQL 上的 WordPress.org
- WPGraphQL 文档:已知限制
- WPGraphQL 文档:兼容性指南
- WPGraphQL 文档:预览
- WooGraphQL 上的 GitHub
- Faust.js 首页
- Faust.js 文档:基本设置
- Faust.js 文档:文章预览
- Faust.js 文档:渲染区块
- Faust.js 文档:区块常见问题
- Faust.js 文档:WordPressBlocksViewer
- Faust.js 博客:回顾 Faust.js 的四年历程
- @faustwp/core 上的 npm
- Faust.js 仓库:实验性 App Router 归档
- Next.js 文档:增量静态再生
- Next.js 文档:revalidatePath
- Next.js 文档:CDN 缓存
官方扩展套件
高级站点模板、AI 系统指令和私人 Discord 社区。一次购买,终身更新。
- 500+ 个网站模板
- AI 系统指令
- 终身更新
- 私有 Discord 社区