# Blockstudio 与 create-block

相同的 block.json，无需 React 编辑器和构建步骤。

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

[查看功能](https://blockstudio.dev/zh/features/blocks/)

@wordpress/create-block 是官方支持的区块起步工具：一个插件、一个 block.json、一个 React 编辑组件，以及 webpack 构建。Blockstudio 保留 block.json 和 WordPress 区块 API，并用由它为你渲染的字段和由服务器渲染的模板取代编辑组件，无需构建。

## 不再需要构建后有哪些变化

Blockstudio 区块就是一个文件夹：block.json 用于字段，模板用于标记，可选资源与它们放在一起。

## 字段，而非控件

在 block.json 中声明一个字段，它的控件就会出现。内置类型有 27 种，从文本到重复字段都有。

## 一个模板

相同的 PHP、Twig 或 Blade 模板会渲染编辑器预览和页面。

## 将编辑器组件写成标签

在模板中写入 RichText 或 InnerBlocks 标签；编辑器会将它们替换为 React。

## 按文件名管理资源

style.scss 在服务器上编译，npm 在 script.js 中导入后会下载到区块中。

## 何时更适合选择 create-block

当编辑体验本身就是产品时：需要自定义工具栏、拖拽交互、画布，或任何需要在编辑器中使用 React 状态的功能。当区块必须保存静态标记，且无需 PHP 也能渲染时。也适用于团队已经在编写 React 并希望使用完整 @wordpress/components 库的情况。

Core 也在转向 PHP。从 WordPress 7.0 起，使用 autoRegister 注册且带有 render 回调的区块，会为字符串、数字、整数和布尔属性生成控件，无需 JavaScript。在这种情况下，富文本、内部区块和媒体仍需要编辑组件。

## 两者可以并行使用

Blockstudio 会通过 register_block_type() 注册任何没有 blockstudio 键的 block.json。使用 wp-scripts 构建一个 create-block 区块，将输出文件夹放入 Blockstudio 目录中，它就会与你的 Blockstudio 区块一起加载。

Blockstudio 注册表会在项目之间复制区块文件夹，因此共享也同样简单：create-block 文件夹可以像其他区块一样传递。

## 并排对比

同一个区块 API，以两种方式编写编辑器端。

维度

create-block

Blockstudio

编辑器 UI

create-block 你编写的 React 编辑组件

Blockstudio 根据 block.json 中的字段生成

构建步骤

create-block 区块加载前先运行 wp-scripts build

Blockstudio 无需构建；模板和资源以文件形式加载

编辑器预览

create-block 你的编辑组件，与输出分开

Blockstudio 相同的服务器端渲染模板

稍后更改标记

create-block 默认是静态的；更改 save() 需要弃用处理

Blockstudio 已有区块会根据模板重新渲染

Interactivity API

create-block 交互式模板，模块构建标志

Blockstudio 一个标志；script.js 作为模块加载

自定义编辑器交互

create-block React 能做的任何事

Blockstudio 字段、自定义字段控件、RichText、InnerBlocks、媒体

许可证

create-block 免费，GPL-2.0-or-later

Blockstudio 免费，GPLv2 或更高版本

## create-block 常见问题

区块开发者在告别构建步骤前常问的问题。

### 还需要 Node 吗？

Blockstudio 块不需要：模板、SCSS 和 ES 模块导入都由 PHP 处理。create-block 项目需要 Node 来运行 wp-scripts，而 @wordpress/scripts 36.1.0 要求 Node 22.22.2 或更高的 22.x 版本、24.15.0 或更高的 24.x 版本，或 Node 26 及以上版本。

### 它还是同一个 block.json 吗？

是。Blockstudio 会读取标准的 block.json，并添加 blockstudio 键来配置字段和设置。名称、标题、分类、支持项等仍按 WordPress 中的定义解释。

### 我可以保留现有的 create-block 区块吗？

可以。将它们的构建输出放入 Blockstudio 目录，Blockstudio 就会通过 register_block_type() 注册它们；也可以让它们留在自己的插件中。只有在生成的字段更适合某个区块时，才需要重写它。

### 何时更适合选择 create-block？

当你需要字段和模板无法实现的编辑器行为、静态保存输出，或团队已经在使用 React 时。对于许多由字段和标记构成、编辑组件大多只是样板代码的区块，Blockstudio 更合适。

### 交互性 API 怎么样？

两者都支持。create-block 交互式模板会配置 supports.interactivity、viewScriptModule 和实验性模块构建标志。在 Blockstudio 中，你可以在 blockstudio 键下设置 interactivity，script.js 会作为模块加载，并自动为你生成导入映射。

## 编写区块，跳过构建

在 block.json 中定义字段，在 PHP、Twig 或 Blade 中编写模板；文件夹一旦存在，区块就会立即出现在编辑器中。

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

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

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

- [区块编辑器手册：@wordpress/create-block](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-create-block/)
- [区块编辑器手册：开始使用 create-block](https://developer.wordpress.org/block-editor/getting-started/devenv/get-started-with-create-block/)
- [区块编辑器手册：区块的文件结构](https://developer.wordpress.org/block-editor/getting-started/fundamentals/file-structure-of-a-block/)
- [区块编辑器手册：编辑和保存](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-edit-save/)
- [区块编辑器手册：弃用](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-deprecation/)
- [区块编辑器手册：静态或动态渲染](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/)
- [区块编辑器手册：交互性 API](https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/)
- [区块编辑器手册：@wordpress/scripts](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-scripts/)
- [区块编辑器手册：@wordpress/create-block-interactive-template](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-create-block-interactive-template/)
- [@wordpress/create-block 在 npm 上](https://www.npmjs.com/package/@wordpress/create-block)
- [@wordpress/scripts 在 npm 上](https://www.npmjs.com/package/@wordpress/scripts)
- [Gutenberg 源码：create-block-interactive-template](https://github.com/WordPress/gutenberg/blob/trunk/packages/create-block-interactive-template/index.js)
- [让 WordPress Core 仅通过 PHP 注册区块](https://make.wordpress.org/core/2026/03/03/php-only-block-registration/)

Plus

## 官方扩展套件

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

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

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