# Blockstudio 与无头 WordPress

一个系统集文件与静态 HTML 于一体，启用后即可使用。

[开始使用](https://blockstudio.dev/zh/docs/)

[静态预渲染](https://blockstudio.dev/zh/features/production/)

无头 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

Blockstudio

需要运行的系统

无头 WordPress WordPress 加一个 Node 前端及其托管服务

Blockstudio 一个 WordPress 安装实例

区块渲染

无头 WordPress 渲染后的 HTML 无需区块脚本，或为每个区块配备一个 React 组件

Blockstudio 每个区块都会渲染自己的模板

预览

无头 WordPress 身份验证、预览路由和共享密钥

Blockstudio WordPress 按发布时的状态进行预览

插件前端

无头 WordPress 每个插件都需要一个 API 扩展和前端代码

Blockstudio 它们仍按原来的方式渲染

内容编辑后立即上线

无头 WordPress 你的代码调用了 revalidatePath；CDN 副本需要单独清除缓存

Blockstudio 启用预渲染后，保存内容会清除文章和首页的缓存

静态页面，速度飞快

无头 WordPress 静态页面和 ISR 页面，可在边缘缓存

Blockstudio 启用后即可使用静态预渲染

前端技术栈

无头 WordPress React 和 Next.js 生态系统

Blockstudio PHP、Twig 或 Blade 模板

## 无头架构常见问题

拆分 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

将模板写成文件，启用静态预渲染，让插件、预览和编辑器继续按原有方式工作。

[静态预渲染](https://blockstudio.dev/zh/features/production/)

[查看所有对比](https://blockstudio.dev/zh/compare/)

## 来源，已选中 2026年10月8日

- [WordPress REST API 手册](https://developer.wordpress.org/rest-api/)
- [WPGraphQL 上的 WordPress.org](https://wordpress.org/plugins/wp-graphql/)
- [WPGraphQL 文档：已知限制](https://www.wpgraphql.com/docs/known-limitations)
- [WPGraphQL 文档：兼容性指南](https://www.wpgraphql.com/docs/compatibility-guide)
- [WPGraphQL 文档：预览](https://www.wpgraphql.com/docs/previews)
- [WooGraphQL 上的 GitHub](https://github.com/wp-graphql/wp-graphql-woocommerce)
- [Faust.js 首页](https://faustjs.org/)
- [Faust.js 文档：基本设置](https://faustjs.org/docs/how-to/basic-setup/)
- [Faust.js 文档：文章预览](https://faustjs.org/docs/how-to/post-previews/)
- [Faust.js 文档：渲染区块](https://faustjs.org/docs/how-to/rendering-blocks/)
- [Faust.js 文档：区块常见问题](https://faustjs.org/docs/explanation/blocks-faq/)
- [Faust.js 文档：WordPressBlocksViewer](https://faustjs.org/docs/reference/wordpress-blocks-viewer/)
- [Faust.js 博客：回顾 Faust.js 的四年历程](https://faustjs.org/blog/a-retrospective-on-4-years-of-faust-js/)
- [@faustwp/core 上的 npm](https://www.npmjs.com/package/@faustwp/core)
- [Faust.js 仓库：实验性 App Router 归档](https://github.com/wpengine/faustjs/tree/archive-experimental-app-router/packages/experimental-app-router)
- [Next.js 文档：增量静态再生](https://nextjs.org/docs/app/guides/incremental-static-regeneration)
- [Next.js 文档：revalidatePath](https://nextjs.org/docs/app/api-reference/functions/revalidatePath)
- [Next.js 文档：CDN 缓存](https://nextjs.org/docs/app/guides/cdn-caching)

Plus

## 官方扩展套件

高级站点模板、AI 系统指令和私人 Discord 社区。一次购买，终身更新。

- 500+ 个网站模板
- AI 系统指令
- 终身更新
- 私有 Discord 社区

[获取 Plus](https://blockstudio.dev/zh/plus/)
