在WordPress中，WP_Query 类是用于创建自定义查询的强大工具。以下是如何在WordPress主题中正确使用 WP_Query 类来创建自定义查询的步骤：

1. 创建一个新的 WP_Query 实例

首先，你需要创建一个新的 WP_Query 实例，并传递一个包含查询参数的数组。

$args = array(
    'post_type' => 'post', // 指定查询的帖子类型
    'posts_per_page' => 5, // 指定每页显示的帖子数量
    // 其他查询参数
);

$query = new WP_Query( $args );

2. 设置查询参数

你可以根据需要设置多个查询参数。以下是一些常用的参数：

• post_type: 指定查询的帖子类型（默认为 'post'）。
• posts_per_page: 指定每页显示的帖子数量。
• paged: 指定当前页码。
• category_name: 指定查询的类别名称。
• tag: 指定查询的标签。
• orderby: 指定排序依据。
• order: 指定排序顺序（'ASC' 或 'DESC'）。

3. 循环输出查询结果

一旦你设置了查询参数并创建了 WP_Query 实例，你可以使用 have_posts() 方法和 the_post() 函数来循环输出查询结果。

if ( $query->have_posts() ) {
    while ( $query->have_posts() ) {
        $query->the_post();
        // 输出帖子内容
        ?>
        <h2><?php the_title(); ?></h2>
        <div><?php the_content(); ?></div>
        <?php
    }
    // 重置帖子数据
    wp_reset_postdata();
} else {
    // 如果没有帖子，可以输出一些信息
    echo '没有找到帖子。';
}

4. 重置帖子数据

在自定义查询之后，使用 wp_reset_postdata() 函数来重置 post 数据，这是非常重要的，因为它确保了后续的查询不会受到影响。

完整示例

以下是一个完整的示例，展示了如何在一个自定义页面模板中使用 WP_Query 来查询特定类别的帖子。

<?php
/*
Template Name: Custom Query Example
*/
?>

<?php get_header(); ?>

<div id="primary" class="content-area">
    <main id="main" class="site-main" role="main">

        <?php
        $args = array(
            'post_type' => 'post',
            'posts_per_page' => 5,
            'category_name' => 'news', // 假设我们要查询的是 'news' 类别的帖子
        );

        $query = new WP_Query( $args );

        if ( $query->have_posts() ) {
            while ( $query->have_posts() ) {
                $query->the_post();
                ?>
                <article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
                    <header class="entry-header">
                        <h2><?php the_title(); ?></h2>
                    </header>

                    <div class="entry-content">
                        <?php the_content(); ?>
                    </div>
                </article>
                <?php
            }
            wp_reset_postdata();
        } else {
            echo '没有找到相关帖子。';
        }
        ?>

    </main>
</div>

<?php get_sidebar(); ?>
<?php get_footer(); ?>

这个示例创建了一个自定义页面模板，它将显示 'news' 类别的最新5篇帖子。记得在创建自定义模板时，你需要将其保存为 .php 文件，并在WordPress的主题文件夹中正确命名。