Go x/text/unicode/bidi 段落方向为什么不同于每个字符方向

Go 的 golang.org/x/text/unicode/bidi 把“整段文本的主方向”和“某一段连续字符运行的方向”分开处理，所以 Paragraph.Direction() 与 Run.Direction() 不一致并不是异常。前者描述段落整体含有哪些方向，后者描述双向算法切出的连续方向运行；混合中文、拉丁字母、阿拉伯文字和数字时，一个段落完全可能是 Mixed，同时包含多个 LTR 与 RTL run。

官方地址：https://pkg.go.dev/golang.org/x/text/unicode/bidi

不要把“段落方向”理解成逐字符方向的汇总数组。先用 Paragraph 判断整体方向，再用 Order 或 Line 取得视觉顺序中的连续 run；如果只想知道某个原文位置属于哪一段，使用 RunAt。

• Paragraph.Direction()：回答整段是左到右、右到左、混合还是中性。
• Ordering.Direction()：回答这次排序结果中的方向属性。
• Run.Direction()：回答一个连续字符运行的方向，不等于每个字符都单独计算。
• Ordering.Run(i)：读取视觉顺序中的第几个 run；Run.Pos() 仍对应原始输入位置。

先分清段落、运行和视觉顺序

双向文本至少有三层结果。第一层是段落级别：库需要知道整段文本是否包含左到右和右到左字符。第二层是运行级别：相邻、方向相同的字符会组成一个 run，阿拉伯文字、英文、数字和中性标点可能被分到不同的连续区间。第三层是视觉顺序：这些 run 为了呈现而重新排列，但每个 Run 的字符串内容仍保持原始顺序。

因此，看到 Direction() == Mixed 时，不应该继续把它当作“每个字符都是 Mixed”。Mixed 只表示段落里同时出现了左到右和右到左方向的字符；真正的局部方向要在 Order() 得到 Ordering 后，通过每个 Run 读取。

用 Paragraph.Direction 判断段落级别

Direction 有四个常见值：LeftToRight、RightToLeft、Mixed 和 Neutral。其中 Mixed 表示文本中同时存在左右方向字符；Neutral 表示没有左右方向字符，且没有设置默认方向。IsLeftToRight() 则更适合回答“渲染时的主方向是否为从左到右”，对混合段落尤其有用。

package main

import (
    "fmt"

    "golang.org/x/text/unicode/bidi"
)

func main() {
    text := "订单 Go 2024 مرحبا"
    var paragraph bidi.Paragraph

    // SetString 只配置一个段落；返回值表示已消费的字节数。
    consumed, err := paragraph.SetString(text)
    if err != nil {
        // 处理选项或输入配置错误，避免继续读取未准备好的段落。
        panic(err)
    }

    // 这里的方向是整段结论，不是每个字符的方向列表。
    fmt.Println("bytes:", consumed)
    fmt.Println("paragraph:", paragraph.Direction())
    fmt.Println("main rendering direction is LTR:", paragraph.IsLeftToRight())
}

对这类混合文本，段落方向通常会告诉你“内容是混合的”，而不会替你决定每个界面控件如何布局。默认方向选项也只是在没有明确方向字符时提供背景方向；一旦文本中含有方向性字符，文本本身会覆盖这个默认值。

用 Order 和 Run.Direction 读取连续方向

Paragraph.Order() 计算整段的视觉运行顺序，返回的 Ordering 中可以用 NumRuns() 和 Run(i) 遍历。每个 Run 是同一方向的连续字符序列，String() 返回它在原文中的字符顺序，Direction() 返回该运行方向，Pos() 返回它在原始输入中的位置。

func printRuns(text string) error {
    var paragraph bidi.Paragraph

    // 先把原始字符串交给 Paragraph，后续位置都基于这份输入。
    if _, err := paragraph.SetString(text); err != nil {
        return err
    }

    ordering, err := paragraph.Order()
    if err != nil {
        return err
    }

    // Run 按视觉顺序读取；Pos 仍然返回原文中的字节区间。
    for i := 0; i 

这里的关键是“遍历顺序”和“原文位置”是两套坐标：遍历 Ordering 是为了获得视觉上的 run 顺序，Pos() 便于你回到原始字符串做换行、标注或映射。不要把 Run.String() 当作已经按界面方向反转后的字符串。

换行时用 Line，位置查询用 RunAt

真实文本通常还要换行。Line(start, end) 计算原文指定区间内一行的视觉运行顺序，适合在你已经决定断行位置后重新排布。若布局算法需要从某个原文位置判断它属于哪个连续运行，可以用 RunAt(pos)；它比逐字符调用方向判断更贴近双向算法的结果。

func lineAt(text string, start, end, pos int) error {
    var paragraph bidi.Paragraph

    // 设置文本后，start/end/pos 都必须使用原始字符串的字节位置。
    if _, err := paragraph.SetString(text); err != nil {
        return err
    }

    line, err := paragraph.Line(start, end)
    if err != nil {
        return err
    }

    // Line 只返回指定区间的视觉运行；RunAt 查询原文位置所属的 run。
    run := paragraph.RunAt(pos)
    fmt.Println("line runs:", line.NumRuns())
    fmt.Println("position direction:", run.Direction())
    return nil
}

位置参数来自原始字符串，而不是屏幕上的列号。UTF-8 中文和阿拉伯文字可能占用多个字节，若把 rune 下标直接传给这些位置参数，得到的区间就会偏移。对需要按字符索引的上层布局代码，应先明确自己的坐标单位，再转换为原始字节位置。

重复 SetString 时不要复用旧 Ordering

Paragraph.SetString 或 SetBytes 会替换段落内容，原先由它产生的 Ordering 随即失效。工程代码中常见的错误是把 Ordering 放进缓存，随后复用同一个 Paragraph 处理下一段文本。正确做法是每次修改段落后重新调用 Order() 或 Line()，并让一个 Ordering 的方法只由一个 goroutine 使用。

如果业务需要并发排版，可以为每个待处理段落准备独立的 Paragraph 和 Ordering，把结果转换成自己的只读数据结构后再交给下游。不要把可变的库对象当成跨任务共享状态。

常见问题

为什么段落是 Mixed，但某个 Run 不是 Mixed？

因为两个值描述的层级不同。段落的 Mixed 表示整段同时包含左右方向字符；一个 run 是连续同向字符，所以它只会报告自己的方向。

Run.Direction 是每个字符的方向吗？

不是。它是该连续运行的方向。需要原文字符类别时可以使用包提供的 LookupString 或 LookupRune，但显示顺序仍应由段落的 Order 或行级 Line 结果决定。

设置 DefaultDirection 后为什么结果没有改变？

默认方向只为缺少明确方向字符的段落提供背景方向；文档说明文本中的方向性字符会覆盖它。先检查输入是否真的只有中性字符，再判断默认值是否应该生效。

能否把 Ordering 放入多个 goroutine 同时读取？

不建议。官方文档明确提示，Ordering 的方法应一次只由一个 goroutine 调用。并发场景应拆分输入和对象，或先在单 goroutine 中提取不可变结果。

归纳来说，Paragraph.Direction() 解决的是“这一段整体属于什么方向”，Run.Direction() 解决的是“这一段连续文本怎么分组”，Ordering 解决的是“这些分组按什么视觉顺序排列”。把三层含义分开，混合语言文本中的方向差异就不再是看似随机的结果。