WordPress while循环$i迭代异常：首元素显1，其余均显3

看起来你的问题核心是迭代变量被意外修改了，我来帮你排查和解决：

最可能的原因：变量名冲突 #

你用的$i是非常通用的变量名，WordPress主题或其他插件的代码里很可能也在使用全局的$i变量，导致你的循环里$i的值被其他代码意外覆盖，出现第一个元素是1，后面直接跳到3且保持不变的情况。

解决方案1：使用独特的变量名 #

把通用的$i换成一个更独特的变量名，比如$post_counter，避免和其他代码的变量冲突：

<?php 
$post_counter = 0; 
// 确保$html变量提前初始化，避免意外拼接
$html = '';
while($posts->have_posts()){ 
    $post_counter++; 
    $posts->the_post(); 
    $html .= '<div class="th-block ' . $post_counter . '">'; 
    $html .= '</div>'; 
} 
echo $html;
// 自定义WP_Query循环后必须重置查询，这是最佳实践
wp_reset_postdata();
?>

解决方案2：限制变量作用域 #

如果你坚持想用$i，可以把变量包裹在局部作用域里，隔离外部代码的干扰：

<?php 
// 用匿名函数创建局部作用域
(function() {
    $i = 0;
    $html = '';
    global $posts;
    while($posts->have_posts()){ 
        $i++; 
        $posts->the_post(); 
        $html .= '<div class="th-block ' . $i . '">'; 
        $html .= '</div>'; 
    } 
    echo $html;
    wp_reset_postdata();
})();
?>

调试步骤帮你确认问题 #

如果还是有问题，可以在循环里加入调试输出，定位变量异常的环节：

<?php 
$post_counter = 0; 
$html = '';
while($posts->have_posts()){ 
    $post_counter++; 
    // 实时输出计数器值，观察是否正常递增
    echo '当前计数器：' . $post_counter . '<br>';
    $posts->the_post(); 
    $html .= '<div class="th-block ' . $post_counter . '">'; 
    $html .= '</div>'; 
} 
echo $html;
wp_reset_postdata();
?>

如果调试输出里$post_counter正常递增，但最终$html里的数值不对，那可能是$html变量之前被其他代码赋值过；如果调试输出里数值直接跳到3，那肯定是其他代码在修改你的计数器变量。

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