在区块编辑器里把段落、按钮、图文都排好了,一点发布,前台却少了一整块,或出现「此区块包含异常内容」。有人立刻换主题,有人把整篇转回经典编辑器再转回来,越修越乱。现场更常见的是:从 Word 或网页粘贴进来的内容把区块结构带坏了;可重用区块或同步模式改了一处,多篇文章一起跑偏;某个插件、安全过滤或优化规则在保存、输出时把区块注释剥掉;页面缓存还在送旧 HTML。编辑器画布上看起来正常,并不等于前台输出的是同一份可通过校验的区块标记。
这和已经写过的「启用区块主题后页头改了不生效或小工具全丢」(已发 11-12-0900)不是一类起点:那篇处理的是站点编辑器里的模板部件、页头页脚和小工具区域;本文的起点是文章或页面正文里的内容区块,卡在校验、粘贴来源或输出被改写。也要和「全局样式改了前后台对不上」(已发 170954174)分开:那是 theme.json 与样式层级让编辑器和前台看起来不像同一套设计;本文即使全局样式已经对齐,仍可能因为无效块、粘贴残留或插件过滤,让前台少块或弹出异常提示。还没有把「块还在不在、校验过没过、是不是粘贴和可重用区块带出来的」看清之前,不要先换主题,也不要同时清空正文、关闭全部区块插件再开一套缓存优化。
更稳的顺序是:先分清是「区块校验失败或块被剥掉」「从外部文档粘贴、或经典内容转换把结构弄坏」「可重用区块或同步模式改串了多页」「主题、插件、安全过滤或缓存改写了输出」→ 先在样本页核编辑器、代码编辑器和前台是否还是同一组区块 → 再清理粘贴来源、核对可重用范围 → 再查插件、过滤和缓存 → 最后做验收和回滚。别一上来同时换主题、整篇转换编辑器并清空缓存,也别只截一张编辑器画布当验收。
先分清:校验失败 / 粘贴或转换破坏结构 / 可重用区块改串 / 输出被改写
「编辑器里排好了,发布后缺块或提示异常」至少有四条岔路,混着改容易把内容结构、主题样式和缓存一起误判:
- 区块本身无效,或保存后块注释不完整 :编辑器里出现「此区块包含异常内容」,或代码编辑器里的
<!-- wp:注释残缺、属性对不上、块json 无法解析。有的块在编辑器里还能看到占位,前台却整段消失。只看画布上的排版,说明不了这块还能通过校验并被正确输出。 - 从 Word、网页或即时通讯工具直接粘贴,或把经典内容整篇转换,把结构带坏了:一次性贴进带样式的表格、浮动图片、嵌套列表后,编辑器会拆成很多无效块或空块;经典文章转区块后,短代码、自定义 HTML 或旧图文布局也可能对不齐。看起来像主题坏了,其实是正文里的块结构已经不干净。
- 改的是可重用区块、同步模式或已插入的图案,影响面被扩大了:改一处标题或按钮,多篇文章或多个落地页一起变;有的页面用的是「同步」副本,有的只是当时插入的静态图案,编辑器里不容易一眼分清。不先核范围,就会把单页内容问题当成全站主题故障。
- 编辑器里是完整的,前台缺块或错位,输出在中途被改写:主题模板、区块相关插件、安全过滤、HTML 压缩、延迟加载或页面缓存,都可能让访客看到的 HTML 和编辑器不一致。已登录预览常常带着未缓存、未过滤的版本,不能当成线上验收。
先记下:出问题的是某一篇文章、某一类落地页,还是所有新发布的页面;编辑器里有没有「异常内容」提示;代码编辑器里块注释是否完整;最近有没有从外部文档粘贴、转换经典内容,或修改过可重用区块;当前页用了哪些区块插件、安全插件和缓存优化。明确这是 正文区块的校验、粘贴来源与输出验收,不是站点编辑器改页头、小工具的专文,也不是 theme.json 全局样式前后台对不上的专文。

第一步:定界 ------ 这次卡在校验、粘贴、可重用还是输出
不要先换主题,更不要先把整篇在区块编辑器和经典编辑器之间来回转换。先把边界看清楚:
- 先对比三处,而不是只看编辑器画布:同一篇打开可视化编辑器、代码编辑器和未登录的前台。画布正常但代码里块注释残缺,优先当校验问题;代码完整但前台缺块,再查输出和缓存;三处都乱,再看是不是粘贴或转换把结构带坏了。
- 把「异常内容」和「只是样式不像」分开:块无效、块丢失、按钮点不开,属于本文要收口的校验和输出问题;仅仅是字号、颜色、间距和编辑器不一致,应回到全局样式和主题层级去查,不要在这篇里先改 theme.json。
- 问题出现的范围:是一篇刚粘贴过的稿,还是所有使用某个可重用区块的页面;是某一种自定义块(表单、价目表、目录、嵌入)不稳定,还是核心段落、图文块也会丢。范围能缩小,后面才知道该改内容还是该查插件。
- 最近做过哪些并行改动:有没有同时粘贴外部文档、更新区块插件、打开安全过滤、转换经典内容,或清过、开过页面缓存。并行改动会让对比和回滚都失真。
- 先固定一篇样本页:选一篇能稳定复现「缺块或异常内容」的文章,记下发布时间、使用的可重用区块和插件组合,后续都对着这一篇改,不要一上来批量「全部转换为区块」。
预期:能一句话说清「这次是块校验没过、粘贴或转换把结构弄坏、可重用区块改串了,还是前台输出被改写」;并确认不是站点编辑器改页头的专文,也不是全局样式前后台对不上的专文。
第二步:先核区块校验与粘贴来源,把样本页结构收干净
来源和结构还没写清之前,不要先换主题或重装 Gutenberg 相关插件。
- 先看区块能不能通过校验:在编辑器里把提示异常的块展开,优先用「尝试恢复」或代码编辑器核对块注释、属性与内容是否成对。能恢复的先恢复并保存一次修订;恢复后仍报错的,把这块的内容拷到纯文本里另起合法块,而不是在损坏的块上继续叠格式。
- 再看是不是粘贴来源把结构带进来的:从 Word、网页、表格或聊天记录贴进来的内容,往往带着多余的 span、行内样式和残缺标签。处理办法是先贴到纯文本中转一层,再在编辑器里按段落、列表、表格、图片重新组织,而不是在已经破碎的块上反复点「转换」。
- 经典内容整篇转换要逐段验收,不要一次点完全站:转换后重点看短代码、自定义 HTML、图文混排和旧按钮是否还在对应的块里。某一段转坏了,只回滚这一篇的修订,不要立刻把全站旧文再转一遍。
- 在 DEVDIY 这类同时写排障说明和落地页的站点里,更常见的是先把一篇样本页的块结构收干净,再决定要不要动可重用区块或插件:常见组合是「对外说明页 + 可重用的号召性按钮或资料模块」,先确认坏的是这一页自己的粘贴残留,还是共享模块被改写,再扩大修改面。
- 先记验收问题,再决定改什么:无效块、粘贴残留、可重用范围不清,应先记在清单里,而不是立刻切换经典编辑器、更换主题或关闭全部区块插件。
涉及区块编辑器排好后前台缺块或提示异常、要先核区块校验与粘贴来源再查插件时,可对照 区块编辑后前台缺块或提示异常时把区块校验、粘贴来源和插件改写核对清楚的要点 把「块注释是否完整、异常内容能不能恢复、粘贴和转换有没有把结构带坏、可重用范围清不清楚」从清单里单独勾掉:先让样本页的区块可校验、来源可讲清,再决定是改共享模块还是查主题和插件------顺序反了,换了主题之后仍然说不清卡在哪一步。
预期:样本页里不再留下无法解析的异常块;能说明损坏是粘贴、转换还是后来编辑造成的;需要扩大到可重用模块或插件时,已经有一篇可对比的干净稿。
第三步:再查可重用区块、主题插件与缓存
样本页的块结构能够保存之后,再查它为什么会在前台丢块,或为什么改一处会牵动很多页。
- 先核可重用区块、同步模式和图案的作用范围:若样本页用了共享模块,先在可重用区块列表里确认这次改的是同步内容还是只读插入的副本。同步模块有问题,应在预发改一处并抽检引用它的页面;不是同步副本的页面,不要到共享模块里去「顺便改」。
- 再查主题和区块插件有没有改写输出:主题更新、区块库、页面构建兼容插件、目录或嵌入类插件,都可能让某一类块在前台消失或退回占位。处理时只对样本页做最小对比:先停用最近更新过的那一个相关插件,而不是一次关掉所有插件。
- 安全过滤、HTML 优化和脚本合并也可能剥掉块标记:过度过滤会把合法的块注释或自定义 HTML 块裁掉;压缩、合并、延迟加载则可能让按钮、页内导航或嵌入块在前台错位。这类问题的特征是编辑器和代码编辑器都完整,未登录前台却缺块或错位。
- 页面缓存和 CDN 要单独复测:刚保存成功、已登录能看见新内容,访客仍可能读到旧 HTML。用未登录、无缓存的地址复查样本页,避免把缓存当成「区块又丢了」。
- 不要把「编辑器里能打开」写成「前台已经验收通过」:验收标准是样本页在未登录前台能看到完整区块、没有异常提示、共享模块的影响范围可说明,而不是编辑器画布看起来整齐。

第四步:验收与回滚
- 用同一篇样本页,在可视化编辑器、代码编辑器和未登录前台各看一遍:异常提示应消失,块注释成对,前台不再缺块。
- 若动过可重用区块或同步模式,再抽检至少两篇引用它的页面,确认改动范围和预期一致,没有把只读插入的页面一起改掉。
- 若关过区块插件、安全过滤或缓存规则,逐项开回并复测,避免一次恢复全部设置后说不清是哪一层又把块改写了。
- 保留样本页改前的修订或导出,确认能回到「虽有问题、但结构可对比」的版本。不要只留下「再整篇转回经典编辑器」这一种操作。
- 验收通过后,再决定要不要把同一规则应用到其他同类页面;不要在样本页还没核清时批量转换旧文。
预期:样本页可复测、共享模块范围可说明、改动可回滚;其他页面是否要批量清理,放到下一轮,不和这次验收绑在一起。
验证
- 样本页在编辑器里不再提示异常内容,代码编辑器里的块注释完整、可解析。
- 未登录、无缓存的前台能看到与编辑器一致的段落、按钮和图文,不再缺整块。
- 若使用了可重用区块或同步模式,能说出改动会影响哪些页面,抽检结果与范围一致。
- 主题、区块插件、安全过滤和缓存的改动都有记录,异常时可以单项回退。
- 没有把站点编辑器的模板部件问题、或全局样式前后台不一致,当成这次正文区块的验收结论。
常见坑
- 编辑器画布看起来整齐,就认为前台一定完整,没有对代码编辑器和未登录页做对比。
- 从 Word 或网页直接粘贴后继续在破碎块上调格式,越改无效块越多。
- 一篇转坏了,就对全站旧文执行「全部转换为区块」,把可回滚的样本页也冲掉。
- 改可重用区块前没有分清同步副本和静态插入,造成多页同时跑偏。
- 还没有核校验和粘贴来源,就同时换主题、关闭全部区块插件并打开新的缓存规则,失败后无法回到可对比的验收。
按「定界校验、粘贴、可重用与输出 → 先把样本页的区块结构和来源收干净 → 再查共享模块、主题插件与缓存 → 验收抽检」这条线走,大多数「区块编辑器里排好了,发布后缺块或提示异常」的问题,能在一个验收窗口内收敛成块可校验、来源可讲清、前台与编辑器一致的状态。需要继续处理已定位的模板部件、页头小工具,或全局样式前后台不一致时,再用已经写过的专文,而不是在样本页的块结构还没核清时并行大改主题和站点编辑器。