本文详解如何使用 wordpress 的 `get_posts()` 函数，通过分类名称（而非 id）精准查询指定分类下的已发布文章，并生成带分类名标题与文章链接与文章链接的响应式列表，兼顾可读性、安全性与主题兼容性。
在 WordPress 主题开发或自定义页面中，常需根据分类名称（如 "fruit" 或 "vegetables"）动态拉取该分类下的全部已发布文章，并以结构化方式展示——例如显示分类名作为标题，点击后跳转至对应文章（而非分类归档页）。这与直接调用 get_categories() 获取分类列表有本质区别：前者面向内容（posts），后者面向分类元数据（terms）。
✅ 正确实现：使用 get_posts() 按分类名称查询
WordPress 提供了 get_posts() 函数，支持通过 'category_name' 参数直接传入分类别名（slug） 来筛选文章。注意：此处必须使用分类的 slug（如 fruit），而非中文名称（如 水果）或 ID。
// 示例：获取 slug 为 'fruit' 的分类下所有已发布文章
$args = array(
'post_type' => 'post',
'post_status' => 'publish',
'category_name' => 'fruit', // ✅ 必须是分类 slug，区分大小写
'posts_per_page' => -1, // 获取全部文章；也可设为 6、12 等限制数量
'orderby' => 'date',
'order' => 'DESC'
);
$fruit_posts = get_posts($args);
if ($fruit_posts) {
echo '<h3>推荐水果</h3>';
echo '<div class="row">';
foreach ($fruit_posts as $post) {
setup_postdata($post); // 确保 the_title()、the_permalink() 等模板标签正常工作
?>
<div class="col-md-4">
<a href="<?php echo esc_url(get_permalink($post)); ?>">
<?php echo esc_html(get_the_title($post)); ?>
</a>
</div>
<?php
}
echo '</div>';
wp_reset_postdata(); // ⚠️ 关键！恢复全局 $post 对象，避免影响后续循环
}? 补充说明与注意事项
- Slug 而非名称：'category_name' 实际匹配的是分类的 URL 友好别名（slug）。可在后台「文章 → 分类目录」中编辑分类，查看并确认其 slug 值（如“蔬菜”分类的 slug 可能是 vegetables）。
- 多分类查询：若需同时获取多个分类的文章，应改用 'cat' 参数（接受逗号分隔的 ID 字符串）或 'category__in'（接受 ID 数组），'category_name' 仅支持单个 slug。
- 性能优化：对高流量页面，建议配合对象缓存（如 Redis）或 Transients API 缓存查询结果，避免每次请求重复数据库查询。
- 安全规范：始终使用 esc_url() 处理链接、esc_html() 处理标题文本，防止 XSS 漏洞；使用 get_permalink($post) 显式传入 $post 对象，确保链接准确无误。
- 主题兼容性：setup_postdata() 和 wp_reset_postdata() 是必需步骤，尤其在循环内调用 the_title() 等函数时，否则可能污染主循环上下文。
通过上述方法，你即可灵活地按分类 slug 动态聚合内容，构建如「精选水果」「当季蔬菜」等语义化内容区块，既符合 WordPress 最佳实践，也易于维护与扩展。
