<x:forEach> 标签（建议收藏）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在 Java Web 开发中，JSTL（JavaServer Pages Standard Tag Library）作为一套标准标签库，为开发者提供了许多简化代码的实用工具。其中 <x:forEach> 标签作为 JSTL 核心库的核心组件之一，是处理数据循环渲染的利器。无论是遍历数组、集合，还是生成动态表格、菜单栏，它都能以简洁的语法和灵活的配置满足需求。本文将从基础到进阶，结合案例详细解析 <x:forEach> 标签的用法，帮助开发者高效掌握这一工具。

一、<x:forEach> 标签的基础语法与核心概念

1.1 什么是<x:forEach>标签？

<x:forEach> 是 JSTL 提供的循环标签，用于在 JSP 页面中重复执行某段代码块。它的功能类似于 Java 语言中的 for 循环，但语法更简洁，且直接作用于页面渲染逻辑。

核心作用：

• 遍历集合（如 List、Map、数组等）
• 动态生成 HTML 结构（如表格、列表、分页组件）
• 在循环体内访问当前项的值、索引、状态等信息

1.2 基本语法结构

<%@ taglib prefix="x" uri="http://java.sun.com/jsp/jstl/core" %>  
<x:forEach [属性列表]>  
    <!-- 循环体内容 -->  
</x:forEach>  

关键属性：
| 属性名 | 描述 |
|-----------------|--------------------------------------------------------------------|
| items | 必须属性，指定要遍历的集合、数组或 Map 的键集合 |
| var | 存储当前循环项的变量名 |
| varStatus | 存储循环状态对象（如索引、是否是首次/末次迭代等） |
| begin | 开始迭代的索引（从0开始） |
| end | 结束迭代的索引（包含该索引） |
| step | 每次迭代的步长，默认为1 |

1.3 简单示例：遍历数字列表

假设需要在页面中输出 1到5 的数字列表：

<x:forEach begin="1" end="5" var="number">  
    <p>当前数字：${number}</p>  
</x:forEach>  

运行结果：

当前数字：1  
当前数字：2  
当前数字：3  
当前数字：4  
当前数字：5  

二、深入解析<x:forEach>的核心能力

2.1 遍历集合与数组

2.1.1 遍历 List 集合

假设有一个 List<String> 类型的 fruits 集合，包含 ["苹果", "香蕉", "橙子"]：

<x:forEach items="${fruits}" var="fruit">  
    <li>${fruit}</li>  
</x:forEach>  

输出效果：

<li>苹果</li>  
<li>香蕉</li>  
<li>橙子</li>  

2.1.2 遍历 Map 对象

当需要遍历 Map<String, String> 类型的数据时，可通过 entrySet() 方法获取键值对：

<x:forEach items="${userMap.entrySet()}" var="entry">  
    <p>键：${entry.key}，值：${entry.value}</p>  
</x:forEach>  

比喻：
想象 Map 是一个快递柜，每个格子有编号（键）和包裹（值），<x:forEach> 就像快递员逐个打开格子，读取编号和包裹信息。

2.2 循环状态与索引控制

2.2.1 使用 varStatus 获取循环状态

通过 varStatus 属性，可以获取当前循环的详细信息：

<x:forEach items="${students}" var="student" varStatus="status">  
    <tr>  
        <td>${status.index + 1}</td> <!-- 索引从0开始，+1 显示为自然序号 -->  
        <td>${student.name}</td>  
        <td>${status.first ? "这是第一条" : ""}</td>  
    </tr>  
</x:forEach>  

关键状态属性：

• index：当前项的索引（从0开始）
• count：当前项的自然序号（从1开始）
• first/last：布尔值，判断是否为第一项或最后一项

2.2.2 灵活控制循环范围

通过 begin、end、step 可实现分页式遍历：

<!-- 显示第3到5项（索引2到4），步长为1 -->  
<x:forEach items="${dataList}" var="item" begin="2" end="4" step="1">  
    ${item}  
</x:forEach>  

三、<x:forEach> 标签的高级用法与场景应用

3.1 嵌套循环与复杂数据结构

3.1.1 多层循环生成表格

假设需要展示一个商品分类与子类别的嵌套表格：

<x:forEach items="${categories}" var="category">  
    <h3>${category.name}</h3>  
    <ul>  
        <x:forEach items="${category.subItems}" var="subItem">  
            <li>${subItem}</li>  
        </x:forEach>  
    </ul>  
</x:forEach>  

比喻：
这就像图书馆的书架，外层循环遍历每个书架（分类），内层循环遍历书架上的每一本书（子类别）。

3.2 动态条件判断与数据过滤

通过结合 <x:if> 标签，可以在循环中实现条件渲染：

<x:forEach items="${products}" var="product">  
    <x:if test="${product.price <= 100}">  
        <div class="discount-item">  
            <p>名称：${product.name}</p>  
            <p>价格：${product.price}（低于100元）</p>  
        </div>  
    </x:if>  
</x:forEach>  

3.3 常见场景：分页与数据分组

3.3.1 分页显示数据

假设每页显示10条数据，可通过 begin 和 end 实现：

<!-- 当前页码为 page，从0开始计数 -->  
<x:forEach items="${allItems}" var="item"  
            begin="${page * 10}" end="${(page + 1) * 10 - 1}">  
    <!-- 渲染当前页数据 -->  
</x:forEach>  

3.3.2 按条件分组展示

例如，将用户列表按性别分组显示：

<!-- 先过滤出男性用户 -->  
<x:forEach items="${users}" var="user" varStatus="status">  
    <x:if test="${user.gender == 'male' && status.first}">  
        <h4>男性用户</h4>  
    </x:if>  
    <x:if test="${user.gender == 'female' && status.first}">  
        <h4>女性用户</h4>  
    </x:if>  
    <p>${user.name}</p>  
</x:forEach>  

四、常见问题与解决方案

4.1 问题1：迭代 Map 时如何直接获取值？

现象：遍历 Map 时，直接使用 items="${map}" 会导致错误。
原因：<x:forEach> 默认遍历 Map 的键集合，需显式指定遍历方式。
解决方案：

<!-- 遍历 Map 的键集合 -->  
<x:forEach items="${userMap}" var="key">  
    ${key}：${userMap[key]}  
</x:forEach>  

<!-- 或遍历 Map 的 Entry 集合（推荐） -->  
<x:forEach items="${userMap.entrySet()}" var="entry">  
    ${entry.key}：${entry.value}  
</x:forEach>  

4.2 问题2：如何避免重复数据？

场景：遍历集合时，数据可能包含重复项，需去重后渲染。
解决方案：

<!-- 假设有一个包含重复值的 List -->  
<x:set var="uniqueItems" value="${fn:distinct(items)}" scope="request"/>  
<x:forEach items="${uniqueItems}" var="item">  
    ${item}  
</x:forEach>  

（需引入 JSTL 的 fn 标签库实现 distinct 方法）

五、实战案例：用户注册列表展示

5.1 需求描述

在后台管理页面中，需要展示注册用户的列表，要求：

1. 按注册时间倒序排列
2. 每页显示10条数据
3. 添加奇偶行背景色区分

5.2 实现代码

<%@ taglib prefix="x" uri="http://java.sun.com/jsp/jstl/core" %>  
<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>  

<!-- 假设 users 是排序后的 List -->  
<table>  
    <x:forEach items="${users}" var="user" varStatus="status"  
               begin="${page * 10}" end="${(page + 1) * 10 - 1}">  
        <tr class="${status.count % 2 == 0 ? 'even' : 'odd'}">  
            <td>${status.count}</td>  
            <td>${user.name}</td>  
            <td>${user.registerTime}</td>  
        </tr>  
    </x:forEach>  
</table>  

六、结论

<x:forEach> 标签作为 JSTL 中的核心循环工具，凭借其简洁的语法和丰富的功能，成为 Java Web 开发中不可或缺的利器。无论是基础的遍历操作，还是复杂的数据分页、条件渲染，它都能通过灵活的配置和嵌套实现高效开发。通过本文的示例与解析，开发者可以逐步掌握其核心用法，并在实际项目中解决循环相关的问题。掌握 <x:forEach> 的精髓，将大幅提升页面动态渲染的效率与代码的可维护性。

关键词布局：

• 文章标题、小标题、关键代码段均自然融入“<x:forEach>标签”关键词
• 通过场景描述和解决方案，间接关联“JSTL循环标签”“Java Web循环渲染”等潜在搜索词
• 代码示例中展示标签的多种属性与用法，覆盖不同搜索需求