将WordPress文章内容/特色图片迁移至ACF灵活内容字段

你的核心问题是没处理ACF嵌套字段的层级结构——Repeater > Flexible Content > WYSIWYG是三层嵌套，你的代码只处理了单层，所以无法正确映射。下面是修正后的实现逻辑和代码：

第一步：确认所有字段的关键信息 #

先去ACF后台，用浏览器开发者工具（F12）查看每个字段的**字段键（field_key）**和布局名：

• Section（Repeater字段）的字段键：比如field_123456
• Section内部的Module（Flexible Content字段）的字段键：比如field_7890ab
• Flexible Content里的「One Column」布局的布局名（ACF后台设置的内部标识，不是前台显示名）：比如one_column
• 「One Column」布局里的WYSIWYG字段名：比如wysiwyg_content
• 要迁移特色图的非嵌套ACF字段键：比如field_cdef12

第二步：修正后的批量迁移代码 #

// 定义目标自定义文章类型（如果是默认文章就留'post'）
$target_post_type = 'post';

// 获取所有需要迁移的文章，优化查询性能
$args = array(
    'post_type'      => $target_post_type,
    'posts_per_page' => -1,
    'post_status'    => 'publish,private,draft', // 按需调整要处理的文章状态
    'no_found_rows'  => true,
);

$myposts = get_posts($args);

// 遍历每篇文章处理
foreach ($myposts as $post) {
    setup_postdata($post);
    $post_id = $post->ID;

    // 1. 获取源数据：默认编辑器内容和特色图ID
    $default_content = get_post_field('post_content', $post_id);
    $featured_image_id = get_post_thumbnail_id($post_id);

    // 2. 构建最内层：One Column布局的内容结构
    $flexible_layout = array(
        'acf_fc_layout' => 'one_column', // 对应Flexible Content的布局标识
        'wysiwyg_content' => $default_content, // 对应布局内的WYSIWYG字段名
    );

    // 3. 构建中间层：Flexible Content的数组（可添加多个布局，这里仅需一个）
    $flexible_content = array($flexible_layout);

    // 4. 构建最外层：Repeater的行结构（可添加多个Section行，这里仅需一个）
    $repeater_rows = array(
        array(
            'field_7890ab' => $flexible_content, // 对应Section内的Module字段键
            // 如果Repeater还有其他字段，在此处补充
        ),
    );

    // 5. 更新嵌套字段：用Repeater的字段键完成写入
    update_field('field_123456', $repeater_rows, $post_id);

    // 6. 迁移特色图到非嵌套ACF字段
    if ($featured_image_id) {
        update_field('field_cdef12', $featured_image_id, $post_id);
    }
}

wp_reset_postdata();

关键注意事项 #

• 替换字段标识：把代码中所有field_xxxxxx和布局名换成你自己的实际值，这是核心，错一个都无法正确映射
• 先测试单篇：在foreach里加if ($post_id == 123) { ... }（123是测试文章ID），先验证单篇没问题再跑批量
• 备份数据库：批量操作前一定要备份，避免数据丢失
• 分批处理：如果文章数量超过500，建议用paged参数分批执行，避免超时
• 清空缓存：迁移后清空ACF缓存和网站缓存，确保字段值正确显示

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