本文介绍如何使用 get_posts() 函数结合全文搜索与自定义分类查询，实现对文章标题、标签（post_tag）甚至分类（category）中包含指定关键词的精准检索，突破默认仅匹配标题的限制。
本文介绍如何使用 get_posts() 函数结合全文搜索与自定义分类查询，实现对文章标题、标签（post_tag）甚至分类（category）中包含指定关键词的精准检索，突破默认仅匹配标题的限制。
WordPress 的 get_posts() 函数默认仅支持通过 's' 参数对文章标题和内容进行全文搜索，不自动匹配标签（tags）或分类（categories）名称。若需扩展搜索范围至标签或分类，必须显式添加 tax_query 参数，将关键词作为分类术语（term）进行关联查询。
以下是一个完整、可直接使用的示例，用于查找标题、内容或标签中包含 “sunflower” 的所有文章：
$args = [
'numberposts' => 99,
's' => 'sunflower', // 匹配标题和正文（含 excerpt）
'tax_query' => [
[
'taxonomy' => 'post_tag',
'field' => 'slug',
'terms' => 'sunflower'
]
],
'post_status' => 'publish', // 推荐显式指定状态，避免获取草稿
];
$postslist = get_posts($args);
⚠️ 注意事项：
-
'field' => 'slug'表示按标签的 URL 友好别名（slug）匹配；若需按中文标签名搜索，请改用'field' => 'name'，但需确保数据库编码兼容且无大小写/空格歧义； - 若还需同时匹配分类（category），可在
tax_query中追加第二个数组项（注意使用'relation' => 'OR'）：
'tax_query' => [
'relation' => 'OR',
[
'taxonomy' => 'post_tag',
'field' => 'slug',
'terms' => 'sunflower'
],
[
'taxonomy' => 'category',
'field' => 'slug',
'terms' => 'sunflower'
]
]
-
get_posts()返回的是WP_Post对象数组（非全局查询），不会影响主循环（The Loop），适合侧边栏、AJAX 或自定义列表场景； - 如需更高性能或更复杂条件（如模糊匹配、多关键词、自定义字段），建议改用
WP_Query或原生 SQL 查询（配合$wpdb），但需谨慎处理 SQL 注入与缓存。
综上，核心思路是：'s' 负责文本内容层搜索，tax_query 负责分类结构层匹配——二者协同，方能真正实现跨维度关键词检索。
