本文详解 acf 中多层嵌套 group 字段（如“工作时间→周一→上午”）的子字段更新方法，纠正 `update_sub_field()` 在非 repeater 场景下的误用，并提供结构清晰、可直接复用的 `update_field()` 数组赋值方案。
在 Advanced Custom Fields（ACF）中，当字段结构为「Group → Group → Sub Field」（即多层静态分组，非 Repeater 或 Flexible Content）时，update_sub_field() 无法直接使用——该函数仅适用于当前已处于 have_rows() / the_row() 循环上下文中的 Repeater 或 Flexible Content 的子字段。而你的字段结构中，'Working hours'（field_61f453c010074）和其下的 'Monday'（field_61f4570e89281）均为 普通 Group 字段（type: group），不支持行循环操作。因此，你最初尝试的 have_rows() + update_sub_field() 逻辑会静默失败（无报错但无效果），这是最常见误区。
✅ 正确做法是：将整个嵌套结构视为一个关联数组，一次性通过 update_field() 写入。ACF 的 update_field() 函数完全支持深层嵌套 Group 字段的批量赋值，只要数组键名严格匹配字段 Key，即可自动映射并保存。
以下是你案例的标准化解决方案（以更新「周一上午」和「周一下午」为例）：
// 构建完整嵌套数组：顶层 Group → 子 Group → 子字段
$value = array(
'field_61f4570e89281' => array( // 'Monday' Group 字段 key
'field_61f4573589282' => !empty($_POST['mon_am']) ? intval($_POST['mon_am']) : '', // 'Am' Number 字段
'field_61f4574589283' => !empty($_POST['mon_pm']) ? intval($_POST['mon_pm']) : '', // 'Pm' Number 字段
),
'field_61f7a30ffbcf0' => array( // 'Tuesday' Group 字段 key（可选扩展）
'field_61f7a30ffbcf1' => !empty($_POST['tue_am']) ? intval($_POST['tue_am']) : '',
'field_61f7a30ffbcf2' => !empty($_POST['tue_pm']) ? intval($_POST['tue_pm']) : '',
),
// ... 其他星期字段同理
);
// 一次性更新顶层 Group 字段（注意：不是 update_sub_field！）
update_field('field_61f453c010074', $value, $post_id);? 关键要点说明：
- ✅ 字段 Key 必须 100% 精确：使用 ACF 字段编辑页右侧显示的 field_xxxxxxxx（而非字段名称如 "Monday"），建议在 ACF 字段设置中开启「Show Field Keys」便于复制。
- ✅ 无需预创建或初始化 Group：ACF 会自动创建缺失的 Group 结构；空值（'' 或 null）会被安全忽略或清空。
- ❌ 避免对 Group 字段调用 have_rows()：Group 是单例容器，无“行”概念；仅 Repeater/Flexible Content 支持循环。
- ⚠️ 安全处理：始终校验 $_POST 数据（如 !empty() + intval()），防止空值或非法类型导致字段保存异常。
- ? 批量更新更高效：相比多次 update_field() 调用，单次传入完整数组性能更优，且保证事务一致性。
? 进阶提示：若未来需支持「每日多个时段」等动态场景，建议将 'Monday' 等改为 Repeater 字段，此时才适用 add_row() + update_sub_field() 模式。但就当前静态七天结构而言，扁平化数组赋值是最简洁、可靠、符合 ACF 最佳实践的方式。
总结：面对嵌套 Group 字段，放弃循环思维，拥抱声明式数组赋值——用 update_field() 直接写入结构化 $value，既精准又健壮。
