技能介绍

要解决的问题

很多 WordPress 站点用 Advanced Custom Fields（ACF）管理结构化内容，比如博客文章里的多组元数据、灵活布局、重复的子字段表格。这些字段组渲染时通常走主题模板里的 get_field() 调用，前端展示与后端逻辑耦合在一起。当你想把某块内容升级成可复用、可拖拽的 Gutenberg 原生区块时，手动重写模板既繁琐又容易出错：重复字段要循环输出、嵌套字段组要维护层级、灵活内容要按布局分支渲染，而区块编辑器那边却只看到一个无法再编辑的 HTML。

这个技能做什么

它基于 ACF Block API v2 和 @wordpress/scripts 搭建迁移管道，把已有的 ACF 字段组转换成原生 Gutenberg 区块。核心思路分三步：

服务端渲染注册：调用 acf_register_block_type() 注册区块类型，复用字段组已有的验证与存储逻辑，避免重写数据层。
字段到属性的映射：将 ACF 的字段值序列化为区块的 block attributes，使区块在编辑器里能读取和修改这些数据，而不是依赖主题模板。
复杂字段的结构翻译：把 ACF Repeater 映射为 InnerBlocks 的使用场景，ACF Group 映射为嵌套区块结构，Flexible Content 映射为可切换的布局区块，保留原有的编辑能力。

适用边界

这个工具解决的是字段层的结构化迁移，不负责视觉层面的前端重构。如果你的字段组依赖大量自定义样式、第三方短代码或主题特有的渲染函数，转换后需要手动核对前端输出。另外，它要求目标站点已启用 Gutenberg 区块编辑器，且 ACF 版本需支持 Block API v2。对于跨站点的字段组迁移（不同数据库结构），需要先对齐字段定义再执行转换。

参考文档：https://www.advancedcustomfields.com/resources/acf_register_block_type/