本文讲解在 wordpress 自定义文章类型（如 `product`）中，使用 acf 分类法字段筛选时因产品归属多个分类而导致的重复输出问题，并提供两种高效、无重复的解决方案。
在开发基于自定义文章类型（如 product）的产品展示页时，若通过 ACF 的「Taxonomy Field」获取多个分类（如 product_category），再对每个分类单独执行 WP_Query 查询——这种“逐分类查产品”的方式极易引发重复渲染：当某款产品同时属于「wireless」和「bluetooth」两个分类时，它将在两次循环中各被输出一次，破坏布局逻辑与用户体验。
✅ 推荐方案一：一次性查询所有匹配产品（最简洁高效）
核心思路是将多次循环查询合并为一次批量查询，利用 tax_query 的 'operator' => 'IN'（默认）行为匹配任意一个指定分类，同时借助 posts_per_page => -1 确保不遗漏，并通过 post__in 或唯一 ID 去重（虽通常无需额外去重，但可加保险）：
'product',
'post_status' => 'publish',
'posts_per_page' => -1,
'tax_query' => array(
array(
'taxonomy' => $custom_taxonomy,
'field' => 'slug',
'terms' => $term_slugs,
// 'operator' => 'IN' —— 默认即为此值，表示“属于任一分类”
),
),
'orderby' => 'date',
'order' => 'DESC'
);
$loop = new WP_Query($args);
if ($loop->have_posts()) :
$product_coming_soon_image = get_field('product_coming_soon_image');
// 使用全局 $post 并重置查询状态（推荐在循环后 wp_reset_postdata()）
while ($loop->have_posts()) : $loop->the_post();
// 获取当前产品所属的所有 product_category 分类 slug，用于 CSS 类名
$terms = get_the_terms(get_the_ID(), $custom_taxonomy);
$terms_string = '';
if ($terms && !is_wp_error($terms)) {
$terms_string = implode(' ', wp_list_pluck($terms, 'slug'));
}
?>
✅ 优势：仅一次数据库查询，性能最优；天然规避重复；结构清晰易维护。
⚠️ 备选方案二：分分类查询 + 手动去重（仅限特殊场景）
若业务强依赖“按分类分组渲染”（例如需为每个分类添加标题或独立容器），则需保留外层 foreach，但必须引入已查询 ID 缓存机制：
'product',
'post_status' => 'publish',
'posts_per_page' => -1,
'post__not_in' => $queried_ids, // 排除已查过的 ID
'tax_query' => array(
array(
'taxonomy' => $custom_taxonomy,
'field' => 'slug',
'terms' => $custom_term->slug,
),
),
);
$loop = new WP_Query($args);
if ($loop->have_posts()) :
while ($loop->have_posts()) : $loop->the_post();
$post_id = get_the_ID();
$queried_ids[] = $post_id; // 记录已处理 ID
// …… 渲染逻辑同上（略）……
endwhile;
wp_reset_postdata();
endif;
endforeach;
?>⚠️ 注意：此方式增加查询次数，性能较低；需确保 $queried_ids 在循环外初始化；post__not_in 对大数据集可能影响效率，慎用于 >1000 条产品。
? 关键注意事项总结
- 永远调用 wp_reset_postdata()：在 WP_Query 循环结束后重置全局 $post，防止干扰主题其他区域（如侧边栏、页脚）。
- 避免 wp_reset_query()：该函数用于 query_posts()（已废弃），在 WP_Query 实例中无效且有害。
- 安全输出属性值：所有动态插入 HTML 的变量（如 class、src、alt）务必使用 esc_attr() 或 esc_url() 过滤。
- ACF 字段健壮性检查：get_field() 返回值可能为 false 或空数组，建议增加 is_array() 和 !empty() 判断。
- 分类法字段返回值确认：ACF Taxonomy Field 若设为“返回 Term 对象”，$product_categories 是对象数组；若设为“返回 Term ID”，需先用 get_term() 转换——本文假设为对象模式。
通过采用一次性批量查询方案，你不仅能彻底解决重复问题，还能显著提升页面加载性能与代码可维护性。
