自定义Gutenberg区块保存标记不更新，求解决方案

你的推测完全正确：Gutenberg中带有save函数的静态区块，会在区块首次插入或编辑保存时，将save函数生成的HTML静态标记存储到数据库的文章内容里。更新save函数后，已存在的旧区块不会自动触发重新渲染——哪怕你重新保存文章，这是因为如果区块的属性（attributes）没有变化，Gutenberg会判定无需重新执行save函数。

下面是具体的解决方法：

方法1：利用区块版本迁移自动更新标记 #

这是官方推荐的静态区块更新方案，能批量处理已有旧区块：

1. 给区块添加版本号
   在注册区块时，新增或更新version字段，初始版本设为1，更新save函数后改为2：

registerBlockType('my-plugin/my-custom-block', {
    title: '我的自定义区块',
    category: 'common',
    // 新增版本号，更新后递增
    version: 2,
    attributes: {
        // 你的区块属性配置
    },
    edit: (props) => {
        // 编辑器侧渲染逻辑
    },
    save: (props) => {
        return (
            <div className="my-custom-class">
                <div>New Markup</div>
            </div>
        );
    }
});

2. 实现迁移函数
   添加migrate函数，告诉Gutenberg如何将旧版本区块转换为新版本。如果只是修改save输出不需要改动属性，直接返回原属性即可——这会触发Gutenberg重新执行save生成新标记：

registerBlockType('my-plugin/my-custom-block', {
    // 其他配置...
    version: 2,
    migrate: (attributes, oldVersion) => {
        // 针对版本1的旧区块，直接返回原属性（可按需修改属性）
        if (oldVersion === 1) {
            return { ...attributes };
        }
        return attributes;
    },
    // ...
});

完成以上配置后，打开包含旧区块的文章（无需修改内容），直接保存即可触发标记更新——Gutenberg会检测到区块版本不一致，自动执行迁移并重新生成最新HTML。

方法2：改用动态区块（彻底避免静态标记问题） #

如果后续需要频繁修改区块输出，推荐改用动态区块：去掉前端save函数，改用服务器端PHP渲染，这样每次页面加载都会实时生成最新标记，完全不依赖数据库存储的静态HTML。

1. 前端注册时移除save函数

registerBlockType('my-plugin/my-custom-block', {
    title: '我的自定义区块',
    category: 'common',
    attributes: {
        // 你的区块属性配置
    },
    edit: (props) => {
        // 编辑器侧渲染逻辑
    },
    // 移除save函数，标记为动态区块
});

2. 服务器端添加渲染回调
   在PHP中注册区块时，指定render_callback：

function register_my_custom_block() {
    register_block_type('my-plugin/my-custom-block', [
        'editor_script' => 'my-block-editor-js', // 你的前端脚本句柄
        'render_callback' => 'render_my_custom_block',
    ]);
}
add_action('init', 'register_my_custom_block');

function render_my_custom_block($attributes) {
    // 这里直接返回最新的HTML标记
    return '<div class="my-custom-class"><div>New Markup</div></div>';
}

改用动态区块后，无论何时修改渲染逻辑，前端都会自动加载最新结果，无需手动更新文章或处理版本迁移。

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