本文详解如何在wordpress主题或插件中，通过php代码精准获取指定分类（按名称或id）下的所有已发布文章，并安全输出带链接的标题列表，适用于首页推荐、专题页聚合等场景。
在WordPress开发中，常需根据分类（Category）动态拉取对应文章——例如为“水果”“蔬菜”两个分类分别生成专属内容区块，且每个区块展示该分类下所有已发布的文章标题，并链接至对应文章详情页。此时，直接遍历分类对象（如使用 get_categories()）仅能获取分类本身，无法自动关联其下属文章；必须借助查询函数主动检索。
WordPress官方推荐的方式是使用 get_posts() 函数，它轻量、安全、不改变主循环（$wp_query），非常适合在模板任意位置嵌入自定义文章列表。
✅ 正确做法：按分类名称获取文章
<?php
// 示例：获取分类名为 'fruit' 的所有已发布文章
$args = array(
'post_type' => 'post', // 限定为文章（可扩展为 'product' 等自定义类型）
'post_status' => 'publish', // 仅获取已发布状态
'category_name' => 'fruit', // 注意：此处填分类 slug（非中文名），如中文分类请用英文slug或改用 ID 方式
'posts_per_page' => -1, // 获取全部，避免分页截断；生产环境建议设合理上限（如 12）
);
$fruit_posts = get_posts($args);
if ($fruit_posts) {
echo '<div class="category-posts-section">';
echo '<h3>水果精选</h3>';
echo '<ul class="post-list">';
foreach ($fruit_posts as $post) {
setup_postdata($post); // 为兼容 the_title()、the_permalink() 等模板标签必需调用
echo '<li>';
echo '<a href="' . esc_url(get_permalink($post)) . '">'
. esc_html(get_the_title($post))
. '</a>';
echo '</li>';
}
echo '</ul>';
echo '</div>';
wp_reset_postdata(); // 关键！重置全局 $post 对象，避免影响后续主循环
}
?>? 重要说明：category_name 参数接收的是分类的 slug（即URL友好标识符），而非显示名称。例如分类后台名为“水果”，其slug通常为 fruit（可在「文章 → 分类目录」中鼠标悬停查看或编辑时确认）。若分类名为中文且未手动设置slug，系统会自动生成拼音或转义值（如 shuiguo），务必以实际slug为准。
✅ 替代方案：按分类ID更稳定（推荐用于多语言/复杂站点）
当分类名称含空格、特殊字符或存在同名分类时，使用ID更可靠：
<?php
// 获取多个分类（ID为 5、8、12）下的文章，支持并集查询
$args_by_id = array(
'post_type' => 'post',
'post_status' => 'publish',
'cat' => '5,8,12', // 注意参数名是 'cat'（非 'category'），值为逗号分隔的整数字符串
'posts_per_page' => 6,
);
$vegetable_posts = get_posts($args_by_id);
?>⚠️ 注意：'cat' 是 WP_Query 兼容参数，get_posts() 内部基于 WP_Query，因此完全支持。但切勿与 'category' 混淆——后者并非标准参数（原问答中示例有误，正确应为 'cat'）。
⚠️ 必须遵守的最佳实践
- 永远转义输出：使用 esc_url() 处理链接、esc_html() 处理标题，防止XSS风险；
- 重置查询上下文：每次调用 get_posts() 后，若使用了 setup_postdata()，必须配对调用 wp_reset_postdata()；
- 避免性能陷阱：'posts_per_page' => -1 在文章量大时易导致内存溢出，建议结合分页或明确限制数量；
- 缓存优化：高频调用可配合 wp_cache_get() / wp_cache_set() 缓存结果，减轻数据库压力。
通过以上方法，你不仅能精准获取目标分类下的文章列表，还能灵活控制排序（添加 'orderby' => 'date', 'order' => 'DESC'）、排除置顶（'ignore_sticky_posts' => true）等高级行为，为构建专业WordPress主题打下坚实基础。
