自定义页面模板中WordPress分页函数无法生效的技术求助

嗨，我完全懂你遇到的困扰——自定义模板里用WP_Query拉取文章，结果默认分页函数根本不工作，只在index.php里正常跑。这是因为WordPress的分页函数（比如the_posts_pagination()）默认依赖全局的$wp_query对象，而你自定义的$query是独立的新实例，分页函数压根不知道它的存在。下面给你两种靠谱的解决方案：

方法1：临时替换全局$query（推荐，代码更简洁） #

这种方法是临时把全局的$wp_query换成你的自定义查询，用完再恢复，这样默认分页函数就能正常识别你的文章列表了。

修改后的完整模板代码如下：

<?php
/* Template Name: News page */
get_header(); 

// 获取当前页码：兼容静态页面的page参数和博客的paged参数
$paged = (get_query_var('paged')) ? get_query_var('paged') : (get_query_var('page') ? get_query_var('page') : 1);

$args = array(
    'post_type' => 'post',
    'paged' => $paged, // 必须加这个参数，分页才会生效
);
$query = new WP_Query($args);
?>

<div id="primary" class="content-area">
    <main id="main" class="site-main full-width pd" role="main">
        <div class="news-loop">
            <div class="row">
                <?php if($query->have_posts()) : while($query->have_posts()) : $query->the_post(); ?>
                    <!-- 这里放你的文章内容输出代码，比如标题、摘要等 -->
                    <h2><?php the_title(); ?></h2>
                    <div><?php the_excerpt(); ?></div>
                <?php endwhile; ?>

                <!-- 分页部分 -->
                <?php
                // 临时替换全局$query
                global $wp_query;
                $temp_wp_query = $wp_query;
                $wp_query = $query;

                // 输出标准分页
                the_posts_pagination(array(
                    'mid_size' => 2, // 中间显示多少个页码
                    'prev_text' => '上一页', // 自定义上一页文本
                    'next_text' => '下一页', // 自定义下一页文本
                    'screen_reader_text' => '文章分页'
                ));

                // 恢复全局$query，避免影响后续功能
                $wp_query = $temp_wp_query;
                ?>

                <?php else : ?>
                    <p><?php _e('暂无文章'); ?></p>
                <?php endif; ?>
            </div>
        </div>
    </main>
</div>

<?php wp_reset_postdata(); // 重置文章数据，避免影响全局 ?>
<?php get_footer(); ?>

方法2：直接使用paginate_links()传递自定义查询参数 #

如果你不想修改全局变量，可以直接用paginate_links()函数，手动传入自定义查询的总页数、当前页码等参数：

在循环结束后添加以下代码：

<?php echo paginate_links(array(
    'base' => get_pagenum_link(1) . '%_%', // 分页链接的基础格式
    'format' => 'page/%#%/', // 分页的URL格式，比如 example.com/news/page/2/
    'current' => $paged, // 当前页码
    'total' => $query->max_num_pages, // 总页数，从自定义查询中获取
    'mid_size' => 2,
    'prev_text' => '上一页',
    'next_text' => '下一页',
    'type' => 'list' // 可以输出为ul列表，方便样式化
)); ?>

关键注意点 #

• 一定要在$args里加上'paged' => $paged，否则WP_Query不会知道要获取哪一页的文章。
• 循环结束后记得调用wp_reset_postdata()，重置全局的文章数据，防止后续的模板标签出错。
• 如果你的自定义页面是设置为静态首页，分页参数会用page而不是paged，所以我们在获取$paged的时候做了兼容处理。

这样修改后，你的自定义模板就能正常使用WordPress的标准分页功能啦！

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