使用Twig+ACF灵活内容：tax_query变量失效问题求助

核心问题分析 #

1. 多分类勾选的文章无法匹配：直接用category.id == departmentt是严格单一分类匹配，忽略了文章同时归属多个分类的场景，需要检查目标分类是否存在于文章的分类集合中。
2. tax_query变量失效：大概率是变量类型不匹配或ACF字段返回格式处理不当——比如ACF返回分类对象而非纯ID/名称，或是变量为字符串而非整数数组，导致查询无法识别。

分步解决方案 #

1. 修复Twig模板的多分类匹配逻辑 #

如果是在Twig中循环过滤文章，不要用严格相等判断，改用in操作符检查目标分类ID是否在文章的分类ID列表内：

{# 假设departmentt是从ACF获取的目标分类ID #}
{% for post in featured_work_posts %}
  {# 把文章的所有分类ID提取为数组 #}
  {% set post_category_ids = post.terms.department|map(cat => cat.id) %}
  {% if departmentt in post_category_ids %}
    {# 渲染符合条件的文章内容 #}
    <div class="featured-work-card">
      <h3>{{ post.title }}</h3>
      {# 其他内容渲染 #}
    </div>
  {% endif %}
{% endfor %}

通过map方法提取文章的所有分类ID，再用in判断目标ID是否存在，就能覆盖多分类勾选的场景。

2. 修复PHP控制器的tax_query变量问题 #

如果是在控制器中用WP_Query直接查询，要确保传给tax_query的terms是整数数组，并正确处理ACF字段的返回值：

// 从ACF灵活内容字段获取选中的分类
$departmentt = get_sub_field('department');

// 统一处理ACF返回格式：转成整数ID或ID数组
$target_terms = [];
if (is_object($departmentt)) {
    // 若ACF返回分类对象，提取ID
    $target_terms[] = (int) $departmentt->term_id;
} elseif (is_numeric($departmentt)) {
    // 若返回单个ID，转成整数并放入数组
    $target_terms[] = (int) $departmentt;
} elseif (is_array($departmentt)) {
    // 若返回多个分类对象，批量提取ID
    $target_terms = array_map(function($term) {
        return (int) $term->term_id;
    }, $departmentt);
}

// 构建WP_Query参数
$args = [
    'post_type'      => 'featured_work',
    'posts_per_page' => -1,
    'tax_query'      => [
        [
            'taxonomy' => 'department', // 替换为你的自定义分类法slug
            'field'    => 'term_id',
            'terms'    => $target_terms,
            'operator' => 'IN', // 匹配包含目标分类的所有文章（含多分类）
        ],
    ],
];

$featured_work_posts = new WP_Query($args);

关键注意事项：

• 确认taxonomy参数是自定义分类法的正确slug
• operator设为IN（默认值，但显式声明更清晰），确保只要文章归属目标分类之一就会被匹配
• 必须将ACF返回值转为整数类型，避免字符串ID导致查询失效

3. 排查变量失效的常见坑 #

• 检查ACF字段设置：在ACF字段编辑页面，确认“返回格式”是“Term ID”还是“Term Object”，对应调整PHP取值逻辑
• 调试变量：控制器中用var_dump($departmentt);查看变量类型和值；Twig中用{{ dump(departmentt) }}调试
• 确认CPT与分类法关联：注册自定义文章类型时，要将自定义分类法添加到taxonomies参数中

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