本文详解 Thymeleaf 中遍历字符串时常见的索引越界错误（如 name.charAt(i) 报错），提供三种安全、简洁的解决方案：修正序列范围、使用数组下标语法、以及直接遍历字符数组。
本文详解 thymeleaf 中遍历字符串时常见的索引越界错误（如 `name.charat(i)` 报错），提供三种安全、简洁的解决方案：修正序列范围、使用数组下标语法、以及直接遍历字符数组。
在 Thymeleaf 模板中，若需按字符逐个渲染字符串（例如将 "Hello" 拆分为
H
e
l
l
o
），直接使用 #numbers.sequence(0, #strings.length(name)) 配合 charAt(i) 会导致 StringIndexOutOfBoundsException —— 根本原因是 #numbers.sequence(start, end) 的 end 参数为包含边界（inclusive），而字符串索引是 0-based，最大合法索引为 length - 1。✅ 正确做法一：修正序列终点
将 #strings.length(name) 改为 #strings.length(name) - 1：
<div th:each="i: ${#numbers.sequence(0, #strings.length(name) - 1)}">
<p th:text="${name[i]}"></p> <!-- 推荐用 [i] 而非 charAt(i) -->
</div>
⚠️ 注意：Thymeleaf 支持对字符串使用方括号语法 name[i] 直接获取第 i 个字符（自动处理类型转换），比 charAt(i) 更简洁且兼容性更好；charAt() 在某些 Thymeleaf 版本或上下文中可能因 EL 解析限制而失败。
✅ 正确做法二：直接遍历字符数组（推荐）
利用 String.toCharArray() 返回 char[]，再用 th:each 遍历，完全规避索引管理：
<div th:each="c: ${name.toCharArray()}">
<p th:text="${c}"></p>
</div>
该方式语义清晰、零出错风险，且性能良好（Thymeleaf 对 char[] 的迭代做了优化）。
✅ 正确做法三：结合 #strings.substring 实现更灵活控制（进阶）
若需带条件或偏移处理，可配合 #strings.substring(name, i, i+1)：
<div th:each="i: ${#numbers.sequence(0, #strings.length(name) - 1)}">
<p th:text="${#strings.substring(name, i, i + 1)}"></p>
</div>
但此方式略冗余，日常场景优先选用前两种。
? 总结建议：
- ❌ 避免 #numbers.sequence(0, len) + charAt(i) 组合（易越界且语法脆弱）；
- ✅ 优先使用 name.toCharArray() 遍历，代码最健壮、可读性最高；
- ✅ 若必须用索引，请始终校验 end = length - 1，并统一采用 name[i] 访问；
- 所有方案均要求 name 非空（null 或空字符串需前置判断，例如 th:if="${!#strings.isEmpty(name)}"）。
