如何在WordPress中通过自定义代码为页面添加评论分页？

我太懂你翻遍老帖子还搞不定的崩溃了——那些2014年前的代码很多已经不兼容现在的WordPress版本了。咱们来把你的代码改得靠谱点，让评论分页正常工作：

你的现有代码的核心问题 #

• $offset 变量没有定义，分页偏移量根本没法计算
• 调用 paginate_comments_links() 但没有用 echo 输出，所以分页按钮不会显示
• 手动用 get_comments() 获取评论时，没有和分页函数的参数联动，导致分页逻辑断裂

修正后的完整代码 #

<?php
// 获取当前评论页码，默认是1（用cpage避免和文章分页的paged变量冲突）
$paged = (get_query_var('cpage')) ? get_query_var('cpage') : 1;
// 每页显示的评论数量
$comments_per_page = 8;
// 计算当前页的评论偏移量
$offset = ($paged - 1) * $comments_per_page;

// 获取当前页面/帖子的ID（确保只拉取当前内容的评论）
$post_id = get_the_ID();

// 组装评论查询参数
$comments_args = array(
    'post_id' => $post_id,
    'number'  => $comments_per_page,
    'status'  => 'approve',
    'offset'  => $offset,
    'order'   => 'ASC' // 可改为DESC让最新评论显示在前面
);
$comments = get_comments($comments_args);
?>

<ol class="comment-list">
    <?php foreach ($comments as $comment) : ?>
        <li class="comment-item">
            <div class="comment-header">
                <?php echo get_avatar($comment, 60); // 显示评论者头像 ?>
                <div class="comment-meta">
                    <span class="comment-author"><?php echo esc_html($comment->comment_author); ?></span>
                    <span class="comment-time"><?php echo get_comment_date('Y-m-d H:i', $comment); ?></span>
                </div>
            </div>
            <div class="comment-body">
                <?php echo wpautop(esc_html($comment->comment_content)); // 安全格式化评论内容 ?>
            </div>
        </li>
    <?php endforeach; ?>
</ol>

<?php
// 输出分页链接，和评论查询参数联动
$pagination_args = array(
    'prev_text' => '« PREV',
    'next_text' => 'NEXT »',
    'type'      => 'list', // 输出为ul列表，方便自定义样式
    'current'   => $paged,
    // 计算总页数：已通过评论数 ÷ 每页显示数，向上取整
    'total'     => ceil(get_comment_count($post_id)['approved'] / $comments_per_page)
);
echo paginate_comments_links($pagination_args);
?>

关键改进点说明 #

1. 正确获取分页变量：用 cpage 是WordPress评论分页的标准变量，不会和文章分页的paged混淆
2. 动态计算偏移量：根据当前页码自动算出该加载哪段评论，避免手动硬编码
3. 关联当前内容：加上post_id参数，确保只拉取当前页面/帖子的评论，不会混进全站内容
4. 安全输出内容：用esc_html()和wpautop()处理评论，既避免XSS风险，又能自动格式化段落
5. 完整分页逻辑：指定total总页数参数，让分页按钮知道有多少页可以跳转，同时用echo输出分页链接

额外注意事项 #

• 如果你的主题自带评论模板，建议先看看comments.php的逻辑，避免自定义代码和主题原有功能冲突
• 即使是朴素 permalink 模式，代码也能正常工作，只是分页URL会变成?cpage=2的形式
• 可以根据需求调整$comments_per_page或order参数，适配不同的展示需求

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