Java Bidi 怎样遍历混合方向文本的视觉区段

Java Bidi 可以提供混合方向文本的区段范围和嵌入级别。要遍历视觉顺序，先收集各个逻辑区段的 start、limit、level，再把级别数组与区段对象交给 Bidi.reorderVisually 重排，最后遍历重排后的对象。不要把原始 run 下标直接当作屏幕从左到右的位置。

官方文档：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/text/Bidi.html

先把区段记录与方向级别分开

设想一个文本查看器，行中既有英文商品编号，又有希伯来文说明和数字。按字符串索引依次绘制每一段，未必得到正确的视觉排列。Bidi 负责方向分析，区段范围仍指向原文的逻辑位置。

level 为偶数表示从左到右，为奇数表示从右到左。不要只记录“LTR 或 RTL”就丢弃具体级别：嵌套级别参与区段重排，两个方向相同的区段仍可能属于不同层次。

为单行文本收集完整区段对象

下面的完整示例把一段文本当作一行处理，使用默认从左到右的段落方向策略。该策略会参考第一个强方向字符，没有强方向字符时才回落到从左到右；如果产品有明确段落方向，应选择对应常量。

import java.text.Bidi;

public class VisualRuns {
    // 区段始终保存原文范围，重排只改变对象数组的顺序。
    static final class Run {
        final int start;
        final int limit;
        final int level;

        Run(int start, int limit, int level) {
            this.start = start;
            this.limit = limit;
            this.level = level;
        }
    }

    public static void main(String[] args) {
        String text = "Item אבג 42 end";
        Bidi bidi = new Bidi(text, Bidi.DIRECTION_DEFAULT_LEFT_TO_RIGHT);
        int count = bidi.getRunCount();
        byte[] levels = new byte[count];
        Object[] runs = new Object[count];

        // 按逻辑区段收集同一份级别和对象，保证两个数组一一对应。
        for (int i = 0; i 

输出用于检查视觉区段序号与原文范围之间的对应关系，本文不提供虚构的实际运行日志。终端自身也可能执行双向显示，所以仅凭某一行看起来的顺序，不能可靠判断算法是否正确。

重排区段对象后再按视觉顺序读取

reorderVisually 的对象数组是承载业务信息的位置。本例把范围与级别放在 Run 中，排序以后每个对象仍然指向原来的子串。方法不负责返回新的字符串，也不会替调用方生成完整字形布局。

尤其不要对 RTL 区段调用普通字符反转，再把所有子串连接起来作为通用显示方案。组合字符、代理对、字形塑形和标点处理都需要正确的文本布局支持。Bidi 的区段信息适合交给排版引擎或用来解释方向关系，不能替代完整渲染。

换行以后使用行级 Bidi

当段落需要折成多行时，先分析段落，然后为已确定的行范围调用 createLineBidi。此时 getRunStart 和 getRunLimit 以该行为起点，若要切回整段原文，应加上行的起始偏移；不要拿行内偏移直接切整段字符串。

例如行起点为 lineStart，某个行区段范围为 start 到 limit，那么它对应段落中的范围就是 lineStart+start 到 lineStart+limit。行宽和断行由布局需求确定，Bidi 本身不测量字体宽度，也不会自动替你找到合适断行位置。

保留逻辑文本并明确索引单位

Java String 的下标以 UTF-16 代码单元计数，不能把区段偏移当成用户可见字符数。实际应用应保留原始逻辑字符串，视觉排列作为显示资料保存；复制、检索和持久化不应随意改写为屏幕顺序。

数字出现在 RTL 文本中就要反转吗？不应按语言猜测，应读取解析后的级别。isMixed 为真说明什么？它用于描述方向情况，不直接给出区段排列，仍需要区段接口。reorderVisually 会修改 levels 吗？它按级别重排对象，不应把原 levels 数组当作重排后的对象元数据；需要级别时像本例一样保存在 Run 对象中。

把段落方向、逻辑区段、视觉排列和最终渲染分别处理，才能在查看器、编辑器或诊断工具中稳定解释混合方向文本。