Java AttributedString 怎样为局部字符范围添加属性

Java AttributedString用addAttribute(key, value, begin, end)为局部范围添加属性，其中begin包含在内、end不包含在内。先确定原文本的下标范围，再添加属性，最后通过AttributedCharacterIterator读取；属性不会直接改变原字符串，也不会自动在控制台显示颜色或粗体。

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

先确定文本、范围与属性的职责

例如订单状态文本只需标注末尾的“待复核”，没有必要把整行都加同一属性。工作流程可以分为文本准备、范围定位、属性赋值和消费读取。AttributedString保存文字及关联属性，实际如何显示取决于读取它的排版或绘制组件。

属性键不是任意字符串，而是AttributedCharacterIterator.Attribute及其子类实例；属性值是否被消费者识别，也必须遵守消费者约定。本文使用标准LANGUAGE属性展示范围，避免把某个UI工具包的显示行为混入基础示例。AttributedString接口

定位子串并添加局部属性

下面完整示例使用indexOf找到目标，确认存在后计算结束下标。代码未在本文环境执行，后文只说明可由文本计算的预期语义。

import java.text.AttributedString;
import java.text.AttributedCharacterIterator;
import java.util.Locale;

public class LocalAttributes {
    public static void main(String[] args) {
        String text = "订单状态：待复核";
        String target = "待复核";
        int begin = text.indexOf(target);
        if (begin 

“订单状态：”占5个UTF-16代码单元，“待复核”占3个，因此预期标注区间是[5,8)。这里的8是结束边界，不是最后一个被标注字符的位置。若目标出现多次，indexOf只定位首次出现；需要多处标注时应明确逐次定位规则。

用迭代器读取属性区间

getAttribute读取迭代器当前字符上的属性，先setIndex定位，再查询。getRunStart和getRunLimit用于读取当前字符所在的属性连续区间，指定LANGUAGE表示按这一属性计算。其他属性可能有不同边界，因此不能假定任意一次run查询都等于最近调用addAttribute的参数。

无参数的run查询涉及全部属性；指定单个属性则关注该键的连续范围。迭代器若仅覆盖原文本的一部分，读取到的区间还受其可访问范围限制。属性迭代器说明

属性值应当不可变，或者由调用者保证不再修改。不要传入一个可变对象后继续改变它，并期待AttributedString替你保存一份独立副本。

遇到补充字符时换算下标

Java String采用UTF-16，下标以char代码单元计数，某些补充字符占两个位置。用户看到的一个符号，不能简单当成下标增加1。若输入范围本来按Unicode码点计数，可以使用offsetByCodePoints换算。String索引规则

下面片段沿用上面示例的import，在已有方法内使用：

// 业务范围以码点计数时，先换算为String使用的UTF-16下标
String text = "A😀B";
int begin = text.offsetByCodePoints(0, 1);
int end = text.offsetByCodePoints(begin, 1);
// 这里的[begin, end)完整覆盖补充字符，不截断代理对
AttributedString attributed = new AttributedString(text);
attributed.addAttribute(
        AttributedCharacterIterator.Attribute.LANGUAGE,
        Locale.ROOT, begin, end);

对于A、补充字符、B组成的文本，示例目标的UTF-16范围为[1,3)。码点也不总等于用户感知的完整字形，例如组合标记或多码点符号；业务若按可见字符选区，需要另外定义文本边界策略。

接入时的速查表

推荐先完成所有属性赋值，再创建供后续组件消费的迭代器，避免交接后继续修改造成调用方理解不一致。空文本、空区间和超出文本边界的范围应按所用重载契约处理，不要把“没有可标注字符”当成正常的非空局部范围。

直接打印AttributedString会看到格式吗？

不会自动得到排版文本。需要消费属性的显示组件，或者像示例一样通过迭代器检查属性信息。

能用字符串color作为属性键吗？

不能把普通String直接作为addAttribute的属性键。使用标准Attribute键或合适子类，显示组件还必须支持相应含义。

替换原文本后原范围还适用吗？

不能直接沿用。文本长度和位置变化后，应重新计算范围并构建对应属性文本，尤其不要把旧文本下标应用到新内容。