如何通过代码为WordPress ACF的选项字段添加新选项？

嘿，这个需求其实挺实用的，我来给你分享下具体的实现思路和代码，完全不用手动去后台加选项～

首先，核心思路就是先获取ACF选择字段的现有配置，检查要添加的选项是否存在，不存在就追加进去，最后更新字段配置。ACF本身提供了专门的函数来做这些操作，不用直接去数据库瞎折腾。

基础单选项添加示例 #

假设你的选择字段的字段键是field_1234567890abc（不知道字段键在哪？打开ACF编辑字段页面，右上角「屏幕选项」里勾选「字段键」就能看到），要添加一个显示文本为「New Category」、值为new_category的选项，代码可以这么写：

// 替换成你的选择字段的实际字段键
$target_field_key = 'field_1234567890abc';
// 要添加的新选项：键是存储值，值是后台显示的文本
$new_option = [
    'new_category' => 'New Category'
];

// 获取当前字段的完整配置
$field = acf_get_field($target_field_key);

// 检查新选项是否已经存在，避免重复添加
foreach ($new_option as $value => $label) {
    if (!isset($field['choices'][$value])) {
        // 追加新选项到现有选项列表
        $field['choices'][$value] = $label;
        // 更新字段配置到数据库
        acf_update_field($target_field_key, $field);
    }
}

批量导入时的优化方案 #

如果是你这种导入数据的场景，肯定会有一堆新选项要处理，挨个加效率太低，不如先把所有需要的选项收集起来，一次性更新：

// 假设这是你要导入的数据源
$import_posts = [
    ['product_tag' => '无线耳机'],
    ['product_tag' => '智能手表'],
    ['product_tag' => '便携音箱'], // 这个是后台还没有的新选项
];

$target_field_key = 'field_1234567890abc';
$field = acf_get_field($target_field_key);
$existing_choices = $field['choices'];

// 先把所有需要的选项整理成ACF要求的格式
$required_options = [];
foreach ($import_posts as $post_data) {
    $tag_label = $post_data['product_tag'];
    // 把显示文本转成符合存储规范的键值（比如小写+下划线）
    $tag_value = sanitize_title($tag_label);
    $required_options[$tag_value] = $tag_label;
}

// 合并现有选项和新选项（自动去重）
$updated_choices = array_merge($existing_choices, $required_options);

// 只有当选项有变化时才更新，减少数据库操作
if ($updated_choices !== $existing_choices) {
    $field['choices'] = $updated_choices;
    acf_update_field($target_field_key, $field);
}

注意事项 #

• 不管是单选还是多选字段，这个逻辑都适用，因为它们的choices结构是完全一样的
• 如果你用的是ACF Pro的其他选择类字段（比如下拉、复选框），同样可以用这个方法
• 记得替换代码里的字段键为你自己的，不然肯定没效果哦

备注：内容来源于stack exchange，提问作者Chozabu