在 wordpress 的 posts 页面（如 index.php 或 archive.php）中，默认的 `get_categories()` 仅返回已关联文章的非空分类；若需显示全部分类（包括暂无文章的空分类），只需设置 `hide_empty => false` 参数即可。
WordPress 提供了多个获取分类的函数，其中 get_categories() 是最常用且灵活的选择。默认情况下，该函数会自动过滤掉“空分类”（即尚未分配给任何文章的分类），这在多数场景下是合理的，但在某些定制需求中（例如侧边栏分类导航、分类目录索引页或后台管理辅助视图），你可能需要展示所有注册的分类，无论其是否已有内容。
要强制显示所有分类（含空分类），只需在参数数组中明确指定 'hide_empty' => false：
<?php
$all_categories = get_categories([
'hide_empty' => false,
'orderby' => 'name',
'order' => 'ASC',
'taxonomy' => 'category' // 可省略，默认即为 category
]);
if (!empty($all_categories)) {
echo '<ul class="category-list">';
foreach ($all_categories as $cat) {
echo '<li><a href="' . esc_url(get_category_link($cat->term_id)) . '">'
. esc_html($cat->name)
. ' <span class="count">(' . absint($cat->count) . ')</span></a></li>';
}
echo '</ul>';
}
?>✅ 关键说明：
- hide_empty => false 是核心参数，必须显式声明；默认值为 true，因此不传参即等同于隐藏空分类。
- 建议配合 esc_url() 和 esc_html() 使用，确保输出安全，防止 XSS 风险。
- 若需排除特定分类（如 ID 为 1 的默认“未分类”），可追加 'exclude' => array(1)。
- 如需按自定义顺序（如ID或别名）排序，可调整 orderby 参数（支持 'id', 'slug', 'count', 'term_group' 等）。
⚠️ 注意：wp_list_categories() 同样支持 hide_empty 参数，用法一致（如 wp_list_categories('hide_empty=0')），但因其输出为 HTML 列表且定制性较低，推荐在需要精细控制结构时优先使用 get_categories() + 手动循环渲染。
总之，这不是逻辑错误，也无需绕过主循环——只需理解 WordPress 分类查询的默认行为，并通过一个简单参数即可满足“显示全部分类”的需求。
