本文详解如何在 wordpress 主题或插件中，使用 php 函数 get_posts() 按分类名称（而非 id）精准获取并展示该分类下的所有已发布文章，并提供可直接复用的代码示例与关键注意事项。
在 WordPress 开发中，若需在首页、侧边栏或自定义页面中动态展示某一特定分类（如“水果”“蔬菜”）下的全部公开文章，而不只是显示分类链接本身，推荐使用核心函数 get_posts() 配合 category_name 参数——它支持通过分类别名（slug） 或分类名称（name） 精准筛选，语义清晰且无需额外查询。
✅ 正确用法：按分类名称/别名获取文章
<?php
// 示例：获取分类别名为 'vegetables' 的所有已发布文章
$args = array(
'post_type' => 'post', // 限定为普通文章（如需自定义类型，可修改）
'post_status' => 'publish', // 仅获取已发布的文章
'category_name' => 'vegetables', // 关键参数：传入分类的 slug（推荐）或 name（需确保唯一）
'posts_per_page' => -1, // 获取全部文章；设为数字（如 6）可分页控制
'orderby' => 'date',
'order' => 'DESC'
);
$vegetable_posts = get_posts($args);
if ($vegetable_posts) {
echo '<div class="category-posts">';
echo '<h3>蔬菜推荐</h3>';
echo '<ul>';
foreach ($vegetable_posts as $post) {
setup_postdata($post); // 必须调用，以支持 the_title()、the_permalink() 等模板标签
echo '<li><a href="' . get_permalink($post->ID) . '">' . get_the_title($post->ID) . '</a></li>';
}
echo '</ul>';
echo '</div>';
wp_reset_postdata(); // 重置全局 $post 对象，避免影响后续循环
}
?>⚠️ 重要说明： category_name 参数实际匹配的是分类的 slug（URL 友好别名），而非后台显示的中文名称。例如，分类名为“水果”，其 slug 通常为 fruit（若未手动修改）。可通过 WordPress 后台「文章 → 分类目录」编辑分类查看并确认 slug。 若需按多个分类联合筛选（如同时属于“水果”和“有机”），应改用 tax_query；category_name 仅支持单个分类。 get_posts() 默认不执行主循环（即不改变全局 $wp_query），因此必须显式调用 setup_postdata() 和 wp_reset_postdata()，否则 the_title()、the_excerpt() 等函数将无法正常工作或返回错误内容。
? 替代方案：按分类 ID 获取（适合动态场景）
当分类 ID 已知（如从 get_categories() 获取），可使用 category 参数（注意：此参数接受字符串形式的 ID 列表，如 '12,15'）：
$category_id = 12; // 假设蔬菜分类 ID 为 12
$posts = get_posts([
'post_type' => 'post',
'post_status' => 'publish',
'category' => (string) $category_id,
'posts_per_page' => 8
]);? 最佳实践总结
- ✅ 优先使用 category_name + 分类 slug，语义明确、易于维护；
- ✅ 始终检查 $posts 是否非空，避免空数组导致 HTML 结构异常；
- ✅ 在 foreach 中务必调用 setup_postdata($post) 并在循环后执行 wp_reset_postdata()；
- ❌ 避免在循环内重复调用 get_category_link() 或 get_term_link()——本需求是跳转到文章页，而非分类页；
- ? 如需展示文章摘要、特色图像或元字段，可在 foreach 内安全使用 get_the_excerpt($post->ID)、get_the_post_thumbnail($post->ID) 等函数。
通过以上方法，您即可灵活、高效地在任意 PHP 上下文中按分类维度组织并呈现 WordPress 文章内容，兼顾性能与可读性。
