本文详解如何使用 acf 的 `update_field()` 函数，精准更新深度嵌套（group 内含 group）结构中的子字段值，避免 `update_sub_field()` 在非 repeater 环境下失效的问题。
在 Advanced Custom Fields（ACF）中，当字段结构为「Group → Group → Sub Field」（即多层静态 Group 嵌套，非 Repeater 或 Flexible Content）时，update_sub_field() 无法直接使用——因为它仅在 have_rows() / the_row() 循环上下文中对 Repeater 或 Flexible Content 的当前行生效。而你的 Working hours 字段（field_61f453c010074）是顶层 Group，其下的 Monday（field_61f4570e89281）仍是普通 Group（非可重复），因此第一种写法逻辑错误：have_rows() 对 Group 字段无意义，循环不会执行，update_sub_field() 也因缺失有效行上下文而静默失败。
✅ 正确做法是：将整个嵌套 Group 结构视为一个关联数组，用 update_field() 一次性写入完整层级数据。ACF 支持通过嵌套数组键名映射字段层级，前提是数组结构与字段定义严格一致。
以下是你案例的推荐解决方案：
✅ 步骤一：构建符合嵌套结构的数组
// 构建完整的 'Working hours' Group 数据（含所有星期）
$working_hours = array(
// Monday Group（注意：字段键名必须与 ACF 后台的 field key 完全一致）
'field_61f4570e89281' => array(
'field_61f4573589282' => !empty($_POST['monday_am']) ? intval($_POST['monday_am']) : 0, // Am
'field_61f4574589283' => !empty($_POST['monday_pm']) ? intval($_POST['monday_pm']) : 0, // Pm
),
// Tuesday Group
'field_61f7a30ffbcf0' => array(
'field_61f7a30ffbcf1' => !empty($_POST['tuesday_am']) ? intval($_POST['tuesday_am']) : 0,
'field_61f7a30ffbcf2' => !empty($_POST['tuesday_pm']) ? intval($_POST['tuesday_pm']) : 0,
),
// ... 其他星期同理（Wednesday 到 Sunday）
);
// 更新顶层 Group 字段
update_field('field_61f453c010074', $working_hours, $post_id);⚠️ 关键注意事项：
- 字段键名必须 100% 匹配：在 ACF 字段编辑页点击“Screen Options” → 勾选“Field Keys”，复制真实的 field_xxxxxxxx（而非字段名称如 monday）。
- 不需预存空数组：ACF 会自动创建缺失的 Group 结构；但若某子 Group 完全未提供（如跳过 Tuesday），该组字段将保持原值或为空。
- 类型强校验：Number 字段务必用 intval() 或 floatval() 转换，避免字符串写入导致前端显示异常。
- 安全过滤：生产环境务必对 $_POST 数据做 sanitize_text_field()、wp_kses_post() 等过滤，防止 XSS 或非法输入。
❌ 常见误区纠正：
- update_sub_field('sub_key', $value)：仅适用于 Repeater/Flexible Content 的当前循环内，对静态 Group 无效。
- update_field('group_key', ['sub_key' => $val])：错误——这会把整个 Group 替换为一个扁平数组，破坏嵌套结构。
- 使用 get_field() + array_merge() 手动拼接：虽可行，但易出错且冗余；update_field() 直接覆盖更简洁可靠。
✅ 最佳实践建议：
将字段结构抽象为常量或配置数组，提升可维护性：
$hour_fields = [
'monday' => ['group' => 'field_61f4570e89281', 'am' => 'field_61f4573589282', 'pm' => 'field_61f4574589283'],
'tuesday' => ['group' => 'field_61f7a30ffbcf0', 'am' => 'field_61f7a30ffbcf1', 'pm' => 'field_61f7a30ffbcf2'],
// ... 其他
];
$data = [];
foreach ($hour_fields as $day => $keys) {
$data[$keys['group']] = [
$keys['am'] => intval($_POST["{$day}_am"] ?? 0),
$keys['pm'] => intval($_POST["{$day}_pm"] ?? 0),
];
}
update_field('field_61f453c010074', $data, $post_id);掌握这一模式后，无论嵌套几层 Group（Group → Group → Group → Text），只需按层级展开数组即可精准赋值——这是 ACF 处理复杂静态结构最稳定、最推荐的方式。
