WordPress 的 WP_Query 支持通过 post_type 参数传入数组（如 ['post', 'product']）或特殊值 'any'，轻松实现多类型内容混合检索，无需额外循环或合并查询。
wordpress 的 wp_query 支持通过 `post_type` 参数传入数组（如 `['post', 'product']`）或特殊值 `'any'`，轻松实现多类型内容混合检索，无需额外循环或合并查询。
在 WordPress 开发中，常需在首页、侧边栏或搜索结果页统一展示普通文章（post）与一个或多个自定义文章类型（如 product、portfolio、event）。幸运的是，WordPress 原生支持将 post_type 设为数组，从而一次性查询多种类型的内容。
✅ 正确用法：使用数组指定多个 post_type
$args = array(
'post_type' => array( 'post', 'product', 'event' ),
'posts_per_page' => 8,
'orderby' => 'date',
'order' => 'DESC',
'post_status' => 'publish'
);
$query = new WP_Query( $args );
if ( $query->have_posts() ) {
while ( $query->have_posts() ) {
$query->the_post();
echo '<h3>' . get_the_title() . '</h3>';
echo '<p>Type: ' . get_post_type() . '</p>';
}
wp_reset_postdata(); // 关键：恢复全局 $post 对象
}⚠️ 注意：务必调用
wp_reset_postdata()（用于WP_Query）或wp_reset_query()（用于query_posts()，不推荐），否则可能影响后续主循环。
✅ 快捷方案：使用 'any' 检索所有可搜索类型
若需获取所有已注册且未被排除的公开文章类型（即 exclude_from_search => false 且非 revision、nav_menu_item 等系统保留类型），可直接使用：
$args = array(
'post_type' => 'any',
'posts_per_page' => 10,
'post_status' => 'publish'
);
$query = new WP_Query( $args );该方式会自动忽略 revision、attachment（除非显式启用）、nav_menu_item 及 exclude_from_search = true 的自定义类型（如部分插件注册的后台管理型 CPT）。
❌ 常见误区提醒
-
get_posts()函数同样支持post_type数组，但默认启用'suppress_filters' => true，若需应用posts_where或pre_get_posts钩子，请显式设为false； - 不要将
post_type写成字符串拼接（如'post,product'），这会导致查询失败； - 自定义文章类型必须已通过
register_post_type()正确注册，且'public' => true或'exclude_from_search' => false才能被常规查询捕获； - 若需排除某类型（如跳过页面），请明确列出目标类型，而非依赖
'any'后再 PHP 过滤——前者更高效。
综上，灵活运用 post_type 数组语法，是构建聚合内容页（如“最新动态”、“全部作品”）最简洁、高性能的实践方式。
