如何调用WordPress默认分页功能？

在WordPress网站中实现文章分页是提升用户体验和SEO效果的关键环节,WordPress内置了高效的分页函数，无需插件即可调用，以下是详细操作指南：

核心分页函数

在主题模板文件（如index.php、archive.php或category.php）的循环结束位置（endwhile;后）插入：

<?php 
the_posts_pagination( array(
    'mid_size'  => 2,          // 当前页码两侧显示的页码数
    'prev_text' => __('« 上一页'), 
    'next_text' => __('下一页 »'),
    'screen_reader_text' => __('文章分页导航') // 屏幕阅读器提示文本
) ); 
?>

参数自定义详解

通过调整数组参数控制分页样式：

• mid_size：当前页左右显示的页码数量（推荐值2-3）
• end_size：首尾显示的页码数量（默认1）
• prev_next：是否显示上一页/下一页按钮（默认true）
• before_page_number/after_page_number：页码前后添加HTML（如<span class="page-link">）

样式优化技巧

默认输出结构包含以下CSS类,可直接通过主题样式表美化：

.pagination {
    margin: 30px 0; /* 控制分页区域间距 */
}
.page-numbers {
    padding: 8px 15px;
    border: 1px solid #ddd;
    margin: 0 5px;
}
.page-numbers.current {
    background: #2271b1;
    color: white;
    border-color: #2271b1;
}

特殊场景处理

1. 自定义查询分页
   使用WP_Query时需在实例化后添加：

   $custom_query = new WP_Query( $args );
   while ( $custom_query->have_posts() ) : ...
   // 循环结束后添加
   echo paginate_links( array(
       'total' => $custom_query->max_num_pages
   ) );

2. 分页空白问题
   当文章数量不足时，分页区域自动隐藏，如需强制显示，添加判断：

   if( $wp_query->max_num_pages > 1 ) {
       the_posts_pagination();
   }

SEO最佳实践

• 语义化结构：默认输出<nav class="navigation pagination">符合HTML5语义标准
• 链接可访问性：screen_reader_text参数确保视障用户可识别导航区域
• URL规范化：分页链接自动添加/page/2/结构，避免重复内容问题

故障排除

• 样式异常：检查主题是否已包含.pagination类样式
• 链接404：确保后台设置→阅读→博客页面至多显示数量小于总文章数
• 插件冲突：停用第三方分页插件后测试

技术依据：本文实现方案遵循WordPress官方文档标准，适用于WordPress 4.1+版本，函数设计符合W3C无障碍标准（WCAG 2.1），分页结构已被Google搜索指南明确列为友好爬行路径。