WordPress归档页主循环分页问题及WP Query方案咨询

问题1：主循环能否实现分页？具体操作方法是什么？ #

完全可以。主循环本身已经内置了分页逻辑，你只需要在循环结束后添加分页输出代码即可，步骤如下：

• 先确认WordPress后台「设置」→「阅读」中，「博客页面至多显示」的数值已设置为你需要的数量（比如20）；
• 在archive.php的主循环代码末尾、endif;之前，添加分页输出函数：

// 简洁的导航式分页
the_posts_navigation();

// 或更灵活的数字分页链接，可自定义样式
echo paginate_links(array(
    'prev_text' => __('上一页'),
    'next_text' => __('下一页'),
    'type'      => 'list'
));

如果你的主题有自定义分页函数（比如部分主题用wp_pagenavi()），也可以直接调用，但要确保主题或对应插件已启用。

问题2：是否可以用WP_Query实现分页？代码示例是什么？ #

可以，但必须正确传递分页参数，否则会出现文章显示错误或分页失效的情况。以下是正确的代码示例：

// 获取当前页码，默认值为1
$paged = get_query_var('paged') ? get_query_var('paged') : 1;

// 构建WP_Query参数
$custom_args = array(
    'post_type'      => 'post', // 若需自定义文章类型，修改此处值
    'posts_per_page' => 20, // 每页显示数量，可与后台设置一致或自定义
    'paged'          => $paged, // *关键参数：传递当前页码*
    'post_status'    => 'publish'
);

$custom_query = new WP_Query($custom_args);

// 自定义循环
if ($custom_query->have_posts()) :
    while ($custom_query->have_posts()) : $custom_query->the_post();
        get_template_part('content', 'archive');
    endwhile;

    // 输出分页，需使用自定义查询的总页数
    echo paginate_links(array(
        'total'   => $custom_query->max_num_pages,
        'current' => $paged,
        'prev_text' => __('上一页'),
        'next_text' => __('下一页')
    ));

    // 重置查询，避免影响后续模板逻辑
    wp_reset_postdata();
else :
    get_template_part('content', 'none');
endif;

注意：必须传递paged参数，分页才会生效；输出分页时要基于自定义查询的max_num_pages获取总页数；循环结束后一定要调用wp_reset_postdata()恢复全局查询变量。

内容的提问来源于stack exchange，提问作者rabox66