本文介绍如何通过判断分类的 parent 属性值为 0，精准筛选出当前页面所属的顶级（主）分类，并在 WP_Query 中仅查询该主分类下的自定义文章，彻底排除子分类文章干扰。

本文介绍如何通过判断分类的 `parent` 属性值为 0，精准筛选出当前页面所属的**顶级（主）分类**，并在 wp_query 中仅查询该主分类下的自定义文章，彻底排除子分类文章干扰。

在 WordPress 自定义分类法（如 'pj-categs'）中，子分类的 parent 属性值为其父分类的 ID（大于 0），而主分类（即顶级分类）的 parent 值恒为 0。因此，不能直接遍历 get_the_terms() 返回的所有分类项——因为当前文章可能同时属于主分类和其子分类，导致 $categorySlug 被覆盖为子分类 slug，最终查询结果混入子分类文章。

正确做法是：先定位当前页面上下文的主分类 slug（而非某篇文章的分类），再以此 slug 构建安全、精准的查询。以下是优化后的完整代码示例：

Chinese Sensitive Words

中文敏感词/违禁词检测与内容合规性检查工具。支持对小红书（Xiaohongshu）、Douyin（抖音）、WeChat（微信）、Weibo（微博）、Bilibili（哔哩哔哩）、Zhihu（知乎）、Taobao（淘宝）、JD.com（京东）等主流平台的禁用词、限用词及高风险词进行文本扫描与合规性分析。

下载

// ✅ 正确获取当前分类归档页的主分类 slug（适用于 category.php 或自定义分类归档模板）
$queried_object = get_queried_object();
$categorySlug = '';

if ($queried_object && isset($queried_object->taxonomy) && $queried_object->taxonomy === 'pj-categs') {
    // 确保是顶级分类（parent == 0）
    if (isset($queried_object->parent) && $queried_object->parent == 0) {
        $categorySlug = $queried_object->slug;
    } else {
        // 若当前是子分类页，向上查找其最近的顶级父分类
        $ancestors = get_ancestors($queried_object->term_id, 'pj-categs', 'taxonomy');
        $top_parent_id = !empty($ancestors) ? end($ancestors) : $queried_object->term_id;
        $top_parent = get_term($top_parent_id, 'pj-categs');
        $categorySlug = $top_parent && !is_wp_error($top_parent) && $top_parent->parent == 0 
            ? $top_parent->slug 
            : '';
    }
}

// ⚠️ 安全兜底：确保有有效 slug 才执行查询
if (empty($categorySlug)) {
    return; // 或触发 notice/warning
}

// 构建仅包含主分类文章的 WP_Query
$the_query = new WP_Query(array(
    'post_type'      => 'your_project_cpt', // ✅ 替换为你的自定义文章类型（如 'project'）
    'tax_query'      => array(
        array(
            'taxonomy' => 'pj-categs',
            'field'    => 'slug',
            'terms'    => $categorySlug,
        ),
    ),
    'posts_per_page' => 12,
    'post__not_in'   => array(get_the_ID()), // 排除当前页面自身（若在单页上下文中调用需确认 ID 有效性）
    'no_found_rows'  => true, // 如无需分页，可提升性能
));

? 关键注意事项：

• ❌ 避免在分类归档页中使用 get_the_terms($post->ID, ...) —— 此时 $post 可能未全局定义或指向错误文章；应优先使用 get_queried_object() 获取当前归档的分类对象。
• ✅ 使用 'tax_query' 数组语法替代过时的 'pj-categs' => $slug 字符串快捷写法，确保兼容性与准确性。
• ? 若需支持“子分类页也只显示其主分类下的文章”，上述代码已内置向上追溯逻辑（get_ancestors）。
• ? 测试建议：在后台创建多层分类结构（如 Design → Web → UI），分别访问 /pj-categs/design/ 和 /pj-categs/web/，验证返回结果是否始终仅为 Design 下的项目。

通过此方案，你将稳定获得纯粹的主分类内容流，为前端展示、分页及 SEO 提供可靠数据基础。