WordPress自定义页面模板循环问题：同分类文章显示相同内容

嘿，这个问题我碰到过好多次啦！你现在遇到的是WordPress自定义查询循环里的经典坑——所有文章都显示第一篇的内容，大概率是循环里漏掉了关键的the_post()调用，或者循环结构不完整导致的。结合你给出的代码片段，我来帮你理清问题和修复方案：

最可能的原因：缺少the_post()方法 #

在while循环体内，必须调用$category_posts->the_post()（自定义查询里用前者更严谨），这个方法的作用是把查询指针移动到下一篇文章，同时更新全局的文章数据对象。如果没加这行，WordPress会一直停留在第一篇文章的数据上，自然所有条目都显示一样的内容。

补全并修正后的完整循环代码 #

把你的代码补全后，正确的写法应该是这样：

<?php
// 设置查询参数，获取分类ID=11的文章
$args = array('cat' => 11);
$category_posts = new WP_Query($args);

// 开始循环逻辑
if($category_posts->have_posts()) : 
    while($category_posts->have_posts()) : 
        $category_posts->the_post(); // 这行是核心！必须加！
?>
        <!-- 这里是你要输出的文章内容模板 -->
        <article class="category-post">
            <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
            <div class="post-excerpt"><?php the_excerpt(); ?></div>
        </article>
<?php
    endwhile; 
    // 重置查询，避免影响后续的主循环（非常重要！）
    wp_reset_postdata();
else :
    // 没有文章时的提示
    echo '<p>这个分类下还没有文章哦～</p>';
endif;
?>

其他需要排查的小细节 #

• 确认你的分类ID确实是11，有没有写错成其他分类？可以在WordPress后台的分类列表里，编辑分类看地址栏的tag_ID参数确认。
• 检查你有没有在循环外面不小心调用过the_post()，导致指针提前跑偏了。
• 如果你在循环里手动用过全局$post变量，一定要确保没有覆盖它，或者循环结束后用wp_reset_postdata()重置回来。

关键知识点提醒 #

• the_post()：没它就没法遍历文章，它会把当前循环的文章数据同步到WordPress的模板标签里，比如the_title()、the_permalink()这些才能拿到对应文章的内容。
• wp_reset_postdata()：自定义查询结束后一定要加，不然后续的主循环（比如页脚的最新文章）会被这个自定义查询影响，出现奇怪的问题。

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