如何调试Gutenberg：导入内容后编辑器显示空白页

1. 逐步缩减定位异常内容 #

• 把导入的文章内容复制到纯文本编辑器（比如记事本），清空原文章的Gutenberg内容，分批次粘贴回编辑器：先粘1/3内容，保存后刷新编辑器；如果正常，再粘下1/3，直到触发空白，精准定位到出问题的段落或内容块。
• 切换到Gutenberg的代码编辑器模式（右上角三个点→代码编辑器），逐块删除HTML结构，每删一块就刷新编辑器，找到导致崩溃的具体块代码。

2. 排查异常块与格式问题 #

• 暂时禁用所有第三方块插件，刷新编辑器看是否恢复。如果正常，再逐个启用插件，定位到冲突的插件。
• 检查导入内容里的自定义块/私有块：在代码编辑器里搜索wp:block，如果出现当前站点未安装的块名称，就是这类无定义的块导致编辑器加载失败。
• 清理特殊格式与无效标签：比如从Word复制来的隐藏样式、不可见字符、未闭合的HTML标签（比如<div>漏写</div>），用正则替换掉多余标签或特殊字符。

3. 用内置工具强化调试 #

• 开启Gutenberg调试模式：在wp-config.php里添加define( 'GUTENBERG_DEBUG', true );，刷新编辑器后会输出更详细的内部错误提示（默认日志可能没捕获到这类问题）。
• 用WP-CLI快速测试：执行wp post get [文章ID] --field=post_content导出原始内容，保存到本地后逐段删除，再用wp post update [文章ID] --post_content="[处理后的内容]"更新文章，比手动编辑更高效定位问题片段。

4. 数据库层面精准排查 #

• 针对该文章的post_content字段做分段测试：用phpMyAdmin把post_content截断为前500字符，更新后看编辑器是否正常；如果正常，逐步增加字符长度，直到找到异常位置对应的内容。
• 检查块的JSON结构：Gutenberg的块内容是JSON包裹的，若JSON有语法错误（比如引号未闭合、多余逗号），编辑器会静默崩溃。可以用本地的JSON校验工具检查块内部的JSON部分。

内容的提问来源于stack exchange，提问作者RuFFCuT