批量将ACF(Pro)图片字段转为WordPress内置特色图片的方法

前提说明 #

假设你的ACF图片字段存储的是图片ID（ACF图片字段最常用的存储格式），如果是URL或数组格式，需对应调整脚本逻辑。请先确认你的ACF字段键（在ACF字段编辑页面查看「字段键」，示例：field_60d21b45a1234）。

方案1：PHP脚本（适合无WP CLI环境） #

将以下代码添加到当前主题的functions.php末尾，或创建一个简单的自定义插件：

function migrate_acf_to_featured_image() {
    // 替换为你的ACF图片字段键
    $acf_field_key = 'your_acf_image_field_key';
    
    // 配置查询参数，可按需调整post_type、post_status
    $args = array(
        'post_type' => 'post',
        'post_status' => 'publish',
        'posts_per_page' => -1,
        'fields' => 'ids', // 仅获取ID提升处理性能
    );
    
    $posts = get_posts($args);
    
    foreach ($posts as $post_id) {
        // 获取ACF字段中的图片ID
        $image_id = get_field($acf_field_key, $post_id);
        
        // 仅当存在图片ID且未设置特色图片时执行
        if ($image_id && !has_post_thumbnail($post_id)) {
            set_post_thumbnail($post_id, $image_id);
            // 日志输出，方便追踪进度（可删除）
            error_log("已为文章ID {$post_id} 设置特色图片，图片ID：{$image_id}");
        }
    }
    
    echo '迁移完成！';
}

// 临时执行：访问网站任意页面后立即注释此行，避免重复执行
// migrate_acf_to_featured_image();

使用步骤 #

1. 替换your_acf_image_field_key为实际字段键
2. 保存文件后访问网站任意前台页面，触发脚本执行
3. 执行完成后，务必注释掉migrate_acf_to_featured_image();这一行
4. 若文章数量过大导致超时，可将posts_per_page改为500/1000，分批多次执行

方案2：WP CLI（推荐，适合3000+大量文章） #

如果服务器已安装WP CLI，直接在终端执行以下命令，无超时风险：

wp eval '
$acf_field_key = "your_acf_image_field_key";
$posts = get_posts(array(
    "post_type" => "post",
    "post_status" => "publish",
    "posts_per_page" => -1,
    "fields" => "ids",
));
foreach ($posts as $post_id) {
    $image_id = get_field($acf_field_key, $post_id);
    if ($image_id && !has_post_thumbnail($post_id)) {
        set_post_thumbnail($post_id, $image_id);
        echo "处理完成：文章ID {$post_id}\n";
    }
}
echo "全部迁移完成！\n";
'

特殊场景调整 #

如果你的ACF字段存储的是图片URL而非ID，将脚本中获取图片ID的部分替换为：

$image_url = get_field($acf_field_key, $post_id);
$image_id = attachment_url_to_postid($image_url);

必备注意事项 #

1. 先备份数据库：操作前务必用备份工具（如UpdraftPlus）备份整个网站数据库，防止数据丢失
2. 先测试少量文章：将posts_per_page改为10，验证脚本正常工作后再批量执行

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