c:forEach中index属性无法正确获取索引值

Question

在使用JSTL的``标签时，开发者常遇到`varStatus="loop"`中的`index`属性无法正确获取预期索引值的问题。典型表现为：当遍历集合为空或条件判断导致部分元素被跳过时，`index`仍从0开始计数，但页面渲染结果出现错位；或在嵌套循环中，内层`index`意外受外层影响。此外，若集合本身包含null元素或使用了`begin`、`end`、`step`等属性控制遍历范围，未正确理解`index`是基于当前迭代位置而非原始集合下标，也会导致逻辑错误。该问题多因对`varStatus.index`语义理解不清所致，需结合实际数据结构与循环控制参数仔细验证。

Answer 1

• 1. JSTL c:forEach 中 varStatus.index 的基础语义解析

在 JSTL（JSP Standard Tag Library）中，<c:forEach> 是最常用的迭代标签之一。其 varStatus 属性提供了一个 LoopTagStatus 对象，用于跟踪当前循环的状态。其中，index 属性表示当前迭代的零基索引（0-based index），即从 0 开始递增，每次迭代加 1，与原始集合的下标无关，而是基于实际执行的迭代次数。

<c:forEach items="${list}" var="item" varStatus="loop">
    <p>Index: ${loop.index}, Value: ${item}</p>
</c:forEach>

若 list 为空，则不会进入循环体，loop.index 不会被渲染；若有 3 个元素，则输出 0、1、2。这是最理想情况下的行为。

场景	集合内容	实际迭代次数	loop.index 输出
空集合	[]	0	无输出
正常遍历	["A", "B", "C"]	3	0, 1, 2
含 null 元素	["A", null, "C"]	3	0, 1, 2

• 2. 条件跳过导致 index 与预期错位的深层分析

当在 <c:forEach> 内部使用 <c:if> 或 <c:when> 进行条件过滤时，loop.index 依然会递增，即使当前元素未被渲染。这意味着 index 并非“可见元素”的索引，而是“已处理元素”的索引。

<c:forEach items="${list}" var="item" varStatus="loop">
    <c:if test="${not empty item}">
        <div>Visible Index: ${loop.index}, Item: ${item}</div>
    </c:if>
</c:forEach>

假设 list = ["A", null, "C"]，输出为：

1. Visible Index: 0, Item: A
2. Visible Index: 2, Item: C

虽然只显示两个有效项，但 index 分别为 0 和 2，中间跳过了 1。这常被误认为是“索引错乱”，实则是对 index 定义理解偏差所致。

• 3. 嵌套循环中 varStatus 的作用域与隔离机制

在嵌套 <c:forEach> 结构中，每个循环可定义独立的 varStatus 变量。若命名冲突或未显式声明，可能引发变量覆盖问题。

<c:forEach items="${outerList}" var="outer" varStatus="outerLoop">
    <c:forEach items="${outer.innerList}" var="inner" varStatus="outerLoop">
        <!-- 注意：此处 outerLoop 被覆盖 -->
        <p>Inner Index: ${outerLoop.index}</p>
    </c:forEach>
</c:forEach>

上述代码中，内层循环错误地复用了 outerLoop，导致外层状态丢失。正确做法应为：

<c:forEach items="${outer.innerList}" var="inner" varStatus="innerLoop">
    <p>Outer Index: ${outerLoop.index}, Inner Index: ${innerLoop.index}</p>
</c:forEach>

通过命名隔离确保各层状态独立，避免逻辑污染。

• 4. begin/end/step 参数对 index 计算的影响机制

当使用 begin、end、step 控制遍历时，loop.index 仍从 0 开始计数，表示当前是第几次迭代，而非集合中的物理位置。

<c:forEach items="${list}" begin="2" end="6" step="2" varStatus="loop">
    <p>Iteration ${loop.index}: ${list[loop.index]} ? No! It's list[${loop.current}]</p>
</c:forEach>

例如，list = [A,B,C,D,E,F,G]，begin=2, end=6, step=2，实际取 C(2), E(4), G(6)。此时 loop.index 输出为 0,1,2 —— 表示三次迭代，而非原始索引。

graph TD
    A[开始遍历] --> B{是否存在 begin/end/step}
    B -->|是| C[计算起始偏移]
    C --> D[逐次推进迭代]
    D --> E[每轮 loop.index += 1]
    E --> F[输出当前项]
    F --> G{是否结束条件满足}
    G -->|否| D
    G -->|是| H[循环终止]

• 5. null 元素与 index 的共存关系及应对策略

集合中包含 null 元素时，<c:forEach> 仍会将其视为一次有效迭代，因此 loop.index 正常递增。若需实现“真实可见索引”，应引入自定义计数器：

<c:set var="visibleIndex" value="0" scope="page"/>
<c:forEach items="${list}" var="item" varStatus="loop">
    <c:if test="${item != null}">
        <c:set var="visibleIndex" value="${visibleIndex + 1}" />
        <div>Real Order: ${visibleIndex}, Data: ${item}</div>
    </c:if>
</c:forEach>

此方法通过手动维护计数器，解耦于 loop.index，适用于分页编号、表格序号等业务场景。