本文讲解如何在 wordpress 主题中精准获取并显示某篇文章实际归属的子分类名称，避免错误列出所有子分类，重点使用 `get_the_category()` 和 `cat_is_ancestor_of()` 函数实现层级化、按需过滤的分类展示。
在 WordPress 主题开发中，常需在文章列表页（如首页或专题归档页）同时展示标题、摘要及所属分类。一个典型需求是：仅显示来自某个父分类（如 ID=1 的“博客”分类）下的文章，并为每篇文章单独显示其实际分配的子分类名称——而非该父分类下所有子分类。原始代码中误用 get_categories( array('child_of' => 1) )，导致每个文章都循环输出全部子分类，违背了“按文归属”的逻辑。
正确做法是：对每篇文章，调用 get_the_category( $post->ID ) 获取其真实分配的全部分类对象数组，再结合分类层级关系进行筛选。该函数返回的是当前文章已勾选的分类（含父类和子类），因此需进一步判断哪些是目标父分类下的子分类。
✅ 推荐方案：按祖先关系精准过滤子分类
假设你的父分类 ID 为 4（例如“技术专栏”），希望只显示属于该父类直接或间接子级的分类名（排除父类自身及其他无关分类），可使用 WordPress 内置函数 cat_is_ancestor_of()：
<div class="blog-items">
<?php
$args = array(
'posts_per_page' => 8,
'category' => 1, // 限定查询来源：仅父分类 ID=1 下的文章
'post_status' => 'publish'
);
$myposts = get_posts($args);
foreach ($myposts as $post) : setup_postdata($post);
?>
<div class="blue">
<p><span>
<?php
$categories = get_the_category($post->ID);
$parent_id = 4; // ✅ 替换为你真正的父分类 ID（如“技术专栏”）
foreach ($categories as $category) {
// 只显示是 $parent_id 的后代（子类、孙类等）的分类名
if (cat_is_ancestor_of($parent_id, $category->term_id)) {
echo esc_html($category->name) . ' ';
}
}
?>
</span></p>
<h3><?php the_title(); ?></h3>
<p><?php the_excerpt(__('(more…)')); ?></p>
<a href="<?php the_permalink(); ?>">阅读更多</a>
</div>
<?php endforeach; ?>
<?php wp_reset_postdata(); // ⚠️ 必须重置全局 $post 对象 ?>
</div>? 关键说明与注意事项
- get_the_category() vs get_categories()：前者按文章维度获取其真实所属分类；后者按分类维度获取分类结构，不关联具体文章。
- cat_is_ancestor_of( $ancestor, $descendant )：参数顺序不可颠倒。$ancestor 是父分类 ID（整数），$descendant 是待检测分类的 term_id（推荐用 $category->term_id，兼容性优于 $category->cat_ID）。
- 安全输出：使用 esc_html() 包裹分类名，防止 XSS 风险。
- 排除父分类自身：若不希望显示父分类名（仅子类），cat_is_ancestor_of() 默认不包含自身（即 $ancestor === $descendant 返回 false），天然满足需求。
- 性能提示：此方案无需额外数据库查询，全部基于已有分类数据，高效可靠。
? 进阶建议
如需仅显示直接子分类（排除孙类等深层子类），可改用 wp_get_post_categories() + 自定义层级检查，或借助 get_term_children() 预先获取所有有效子类 ID 数组再比对。但对于绝大多数场景，上述 cat_is_ancestor_of() 方案已足够精准、简洁且符合 WordPress 最佳实践。
