Java AttributedCharacterIterator 怎样按属性区间遍历文本

Java 中如果文本同时带有字体、颜色或其他属性，不建议在循环里逐个字符比较属性。更稳妥的做法是让 AttributedCharacterIterator 根据当前位置计算连续属性区间：getRunStart 返回区间起点，getRunLimit 返回区间末尾的下一个索引，然后按 [start, limit) 读取文本。循环结束时再用 CharacterIterator.DONE 判断是否到达终点。

官方地址：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/text/AttributedCharacterIterator.html

处理这类文本时，先把当前位置放在一个有效字符上，再取得区间边界；每轮直接把索引推进到本区间的 runLimit，就能避免重复扫描和边界错位。

先把属性区间看成半开区间

一个 run 是相对于某个属性或一组属性的最大连续文本范围。比如一段文字从索引 0 到 8，其中索引 0～3 使用同一种字体，那么字体 run 可以表示成 [0, 4)。这里的 4 不属于当前片段，它只是下一段的起点。

getRunStart() 和 getRunLimit() 依据全部属性计算；传入一个属性时，只关注这个属性；传入属性集合时，则要求集合中的属性同时满足连续条件。官方 API 还规定，返回索引不会超出迭代器自己的 begin/end 范围。

单个属性遍历：每轮用区间末端推进

下面的例子给一段文本设置两种字体，并只按 TextAttribute.FONT 切分。注意 AttributedString 的属性范围也是半开区间，addAttribute 的结束索引不包含在属性范围内。

import java.awt.Font;
import java.text.AttributedCharacterIterator;
import java.text.AttributedString;
import java.text.CharacterIterator;
import java.awt.font.TextAttribute;

public class FontRuns {
    public static void main(String[] args) {
        String text = "Java 区间遍历";
        AttributedString source = new AttributedString(text);
        // 前半段使用粗体，结束索引 5 不包含在属性范围内。
        source.addAttribute(TextAttribute.FONT, new Font("Serif", Font.BOLD, 18), 0, 5);
        // 后半段使用普通字体，覆盖剩余字符。
        source.addAttribute(TextAttribute.FONT, new Font("Serif", Font.PLAIN, 18), 5, text.length());

        AttributedCharacterIterator iterator = source.getIterator();
        for (int index = iterator.first(); index != CharacterIterator.DONE; ) {
            // 当前字符必须有效，才能取得它所在属性 run 的边界。
            int start = iterator.getRunStart(TextAttribute.FONT);
            int limit = iterator.getRunLimit(TextAttribute.FONT);
            String segment = slice(iterator, start, limit);
            Object font = iterator.getAttribute(TextAttribute.FONT);
            System.out.printf("[%d, %d) %s -> %s%n", start, limit, segment, font);

            // 直接跳到本段末尾，避免在同一 run 内逐字符重复计算。
            index = iterator.setIndex(limit);
        }
    }

    private static String slice(AttributedCharacterIterator iterator, int start, int limit) {
        StringBuilder result = new StringBuilder(limit - start);
        // 用明确的半开区间读取字符，避免把下一段首字符带进来。
        for (int index = start; index 

这段代码的关键是两点：第一，getAttribute 读取的是当前位置的属性，因此要在跳到 limit 之前保存本段信息；第二，setIndex(limit) 在 limit 等于 end 时会返回 DONE，下一轮自然结束。若读取的是较大的文本，按 run 推进比每个字符都做一次边界判断更容易维护。

多个属性一起决定遍历边界

如果字体和颜色都可能单独变化，只按字体取 run 会把同字体但不同颜色的部分合在一起。此时可使用无参的 getRunStart()/getRunLimit()，让全部属性共同决定边界；也可以传入一个属性集合，限定关注范围。

import java.text.AttributedCharacterIterator;
import java.text.AttributedString;
import java.text.CharacterIterator;
import java.awt.font.TextAttribute;
import java.util.Map;
import java.util.Set;

public class AttributeRuns {
    public static void printRuns(AttributedString source) {
        AttributedCharacterIterator iterator = source.getIterator();
        Set keys = Set.of(
                TextAttribute.FONT, TextAttribute.FOREGROUND);

        for (int index = iterator.first(); index != CharacterIterator.DONE; ) {
            // 属性集合让字体或颜色任一变化都切出新的区间。
            int start = iterator.getRunStart(keys);
            int limit = iterator.getRunLimit(keys);
            Map values = iterator.getAttributes();
            System.out.printf("[%d, %d) %s%n", start, limit, values);

            // 当前区间已经处理完，下一次从 limit 重新定位。
            index = iterator.setIndex(limit);
        }
    }
}

getAttributes() 返回当前字符上定义的属性映射；某个属性没有定义时，getAttribute 会返回 null。因此，业务代码要区分“该字符没有这个属性”和“属性值本身是一个特殊对象”这两种情况。集合版查询只影响区间边界，读取当前属性仍然可以使用 getAttribute 或 getAttributes。

上线前的边界复查

把这段遍历放进服务或批处理程序前，可以按下面的值班式清单复查：

若只关心一个属性，传入具体的 AttributedCharacterIterator.Attribute；若要得到完整的视觉片段，使用无参方法或属性集合。两种写法都不需要把迭代器复制成字符串后再逐字符扫描。

常见追问

为什么 runLimit 不是当前片段最后一个字符的索引？
因为它采用半开区间设计，返回的是第一个不属于当前 run 的位置，正好可以作为下一轮的索引。

只调用 getRunStart() 和 getRunLimit() 能否遍历文本？
可以，但它们按全部属性共同划分区间。如果业务只关心字体或颜色，显式传入对应属性能让边界含义更清楚。