WordPress 块主题与全站编辑 FSE 完全指南:从 theme.json 配置到模板部件组织的完整流程
2026 年,全站编辑已经从“未来趋势”变成了“现在进行时”。基于块编辑器的全站编辑已经成为主流项目的标配。与传统主题不同,块主题的核心是 theme.json 文件,它定义了整个网站的设计系统。
块主题与传统主题的根本区别
传统主题依赖 PHP 模板文件,样式通过 style.css 控制。而块主题使用 HTML 模板文件,文件格式为 .html,以及 theme.json 配置文件,所有样式和布局都在块编辑器中可调。
块主题的设计理念是:让用户在浏览器中完成设计和开发,无需编写代码。这并不意味着开发者不需要技术能力,而是将技术能力从“写代码”转变为“配置系统”。
theme.json 文件:块主题的核心
theme.json 是块主题的配置文件,它定义了整个网站的设计系统。通过这个文件,你可以定义颜色调色板,包括主色、辅助色、背景色和文本色。你还可以定义字体体系,包括字体族、字号、行高和字重。间距方面,可以控制边距、内边距和块间距。边框方面,可以定义宽度、颜色和圆角。此外还可以控制阴影等视觉设计令牌。
theme.json 让主题开发从“写 CSS”变成了“配置设计系统”,大幅降低了主题定制的门槛。
模板和模板部件
在块主题中,模板文件是 .html 格式的,内容由块组成。模板定义了特定页面类型的整体布局,比如首页模板、单页模板和归档模板等。
模板部件是可复用的块组合,如页眉、页脚和侧边栏。它们可以在多个模板中重复使用,修改一处即可同步更新所有引用位置。
块样式和样式变体
块样式允许为同一个块提供多种预置外观。比如“按钮”块可以提供“主要按钮”、“次要按钮”和“轮廓按钮”三种样式,用户可以在编辑器中一键切换。
样式变体则是整个主题的预设风格集合,用户可以一键切换不同的设计风格,而不需要更换主题。
创建块主题的推荐工具
对于块主题开发,Create Block Theme 插件是一个非常实用的工具。它允许你在 WordPress 内部构建自定义块主题。你可以从零开始构建主题,也可以基于当前站点的活跃主题创建新主题,或者创建子主题,甚至创建样式变体。完成后,你可以将主题导出供其他地方使用。
2026 年块主题开发的技术栈
在 2026 年,块主题开发的技术栈已经相当成熟。区块编辑器深度集成是核心,通过 block.json 定义自定义区块。React 作为底层框架,提供了丰富的交互能力。JavaScript 工具链包括 Webpack 和 ES6 模块等。
对于仅 PHP 开发者,WordPress 7.0 引入了仅 PHP 的块注册功能,开发者可以在服务器端仅使用 PHP 创建块和模式,自动通过块 API 注册。这大大降低了不熟悉 JavaScript 工具链的 PHP 开发者的入门门槛。

