ACF复选框返回单字符串而非数组，如何获取正确数组格式？

先检查字段设置细节 #

• 确认复选框字段的返回格式确实是「Value」，别误选成「Label」或「Label & Value」。建议重新保存字段组，避免设置未生效。
• 核对每个复选框的「值」和「标签」，确保值里没有误加|分隔符，也不要把标签当成值填写。

临时救急：手动拆分返回值 #

如果暂时找不到设置问题，用代码把分隔字符串拆成目标数组：

$checkbox_raw = get_field('checkboxes');
$checkbox_values = [];
if (isset($checkbox_raw[0]) && !empty($checkbox_raw[0])) {
    $checkbox_values = explode(' | ', $checkbox_raw[0]);
}
// 此时$checkbox_values就是你需要的格式：Array([0] => checkbox1, [1] => checkbox2...)

排查字段注册与缓存问题 #

• 要是你用代码注册ACF字段，检查return_format参数是否设为'value'，示例：

  acf_add_field(array(
      'key' => 'field_checkboxes',
      'name' => 'checkboxes',
      'type' => 'checkbox',
      'return_format' => 'value', // 必须设置为这个值
      'choices' => array(
          'checkbox1' => 'Checkbox 1 标签',
          'checkbox2' => 'Checkbox 2 标签',
      ),
  ));
  

• 刷新后台并清除网站缓存，有时候缓存会导致旧设置继续生效。

排查冲突问题 #

• 暂时禁用其他插件，测试是否有插件篡改了ACF的返回值。
• 切换到WordPress默认主题（如Twenty Twenty-Four），验证是否是主题函数干扰了字段返回结果。

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