Go x/text/unicode/bidi 右向文本为什么不能简单调用字符串反转

结论先说：Go x/text/unicode/bidi 里的右向文本不能靠“把字符串从头到尾反过来”完成排版。双向文本通常同时包含 RTL 字符、拉丁字母、数字和标点，真正需要决定的是每个连续 run 的方向与视觉顺序；整串反转只改变字符顺序，不能替代段落级 BiDi 处理。

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

先判断：你遇到的是反转问题还是排版问题

线上日志常见的触发信号有三种：阿拉伯文或希伯来文旁边的数字跑到意外位置；括号、斜杠和标点看起来与字段不配对；同一段中混入英文订单号后，简单的反转结果与界面渲染不一致。它们都说明“字符存储顺序”和“视觉显示顺序”被混为一谈。

先把问题缩小成两个问题：

• 你只是需要一个明确的字符顺序变换，例如处理一段已经确定方向的文本？
• 你需要把一个段落按 Unicode 双向规则拆成不同方向的 runs，再交给排版层？

前者可以考虑 ReverseString；后者应从 Paragraph.SetString、Order 或 Line 开始。不要因为函数名里有 “Reverse” 就把它当作 RTL 渲染器。

为什么整串反转会把问题放大

混合文本不是一条只有“左”或“右”的字符带。一个段落可以同时有 LTR run、RTL run、数字 run 和中性标点。数字通常需要保持自己的连续关系，括号还涉及成对字符的方向对应；如果先把整串切成 rune 再倒序，得到的只是另一种逻辑字符排列，不是排版引擎要展示的视觉顺序。

bidi.ReverseString 的官方定义很明确：它反转字符串中的字符顺序，修饰符仍跟随所修饰的 rune，括号替换为对应的另一侧。这个能力适合“我确实要反转字符”的场景，但它没有返回一个经过段落分析的 Ordering，也不负责按行切分。

快速判断：先让 Paragraph 告诉你整体方向

排查时先不要急着拼接输出。把原文交给 Paragraph.SetString，记录它返回的消费字节数和错误，再读取 Direction、IsLeftToRight。官方 API 将整体方向区分为 LeftToRight、RightToLeft、Mixed 和 Neutral；出现 Mixed 时，整串反转尤其容易掩盖真实问题。

package main

import (
    "fmt"

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

func inspectParagraph(text string) error {
    var p bidi.Paragraph

    // 设置一个默认方向；文本中的强方向字符仍会覆盖这个默认值。
    consumed, err := p.SetString(text, bidi.DefaultDirection(bidi.LeftToRight))
    if err != nil {
        return fmt.Errorf("设置双向段落失败: %w", err)
    }

    // 先观察包实际消费的字节数，避免把多个段落误当成一个输入。
    fmt.Printf("consumed=%d direction=%v leftToRight=%v\n",
        consumed, p.Direction(), p.IsLeftToRight())
    return nil
}

func main() {
    // 这里故意混入右向文字、拉丁字母、数字和标点，模拟业务字段。
    if err := inspectParagraph("مرحبا Go 2026 (A-17)"); err != nil {
        fmt.Println(err)
    }
}

这里的 consumed 是定位输入边界的信号，不是视觉排序结果。若原始字节中包含段落分隔符，SetString 只处理第一个段落，并把包含分隔符在内的消费数量返回；不要把剩余文本悄悄拼到当前段落后面。

处理步骤：用 Order 查看视觉 runs

确认输入是混合方向后，调用 p.Order()。它返回一个 Ordering，表示该段落中 runs 的视觉顺序。每个 Run 仍可以读取原文位置、方向和原始顺序文本，因此排查时应先打印这些元数据，确认哪一段被当成 LTR、哪一段被当成 RTL，再决定交给渲染层的结构。

func inspectRuns(text string) error {
    var p bidi.Paragraph

    // 输入只绑定到这个 Paragraph；复用前要重新确认旧 Ordering 已经失效。
    if _, err := p.SetString(text, bidi.DefaultDirection(bidi.LeftToRight)); err != nil {
        return fmt.Errorf("设置段落失败: %w", err)
    }

    ordering, err := p.Order()
    if err != nil {
        return fmt.Errorf("计算视觉顺序失败: %w", err)
    }

    // Ordering 的方法只在一个 goroutine 中顺序读取，避免并发消费同一结果。
    fmt.Printf("ordering=%v runs=%d\n", ordering.Direction(), ordering.NumRuns())
    for i := 0; i 

这段代码的重点不是把 Run.String() 直接拼成一个新字符串，而是建立一份可解释的诊断记录。Run.String 和 Run.Bytes 返回 run 在原文中的顺序；Ordering.Run(i) 负责给出视觉排序中的第 i 个 run。二者配合起来，才能定位“显示顺序错了”究竟是输入边界错、方向判断错，还是渲染层没有按 runs 处理。

按行排版：不要把整个段落的 Order 当成每一行

如果业务层需要换行，使用 p.Line(start, end) 计算指定原文位置范围内的一行视觉顺序。Order 适合查看整个段落的 runs，Line 适合排版器已经确定行范围后的局部计算。

func orderOneLine(text string, start, end int) error {
    var p bidi.Paragraph

    // 先把段落装入对象，start/end 必须对应这段原文的位置范围。
    if _, err := p.SetString(text); err != nil {
        return fmt.Errorf("设置段落失败: %w", err)
    }

    line, err := p.Line(start, end)
    if err != nil {
        return fmt.Errorf("计算单行顺序失败: %w", err)
    }

    // 这里只输出 run 元数据；最终字形布局仍由上层排版组件完成。
    for i := 0; i 

边界处理是这里最容易漏掉的地方：Run.Pos 报告的是相对于 SetString 或 SetBytes 原文的位置，排版器应使用同一份输入和同一套位置定义。不要先把字符串转换成另一份经过清洗或拼接的文本，再拿旧位置调用 Line。

回滚路径：什么时候退回 ReverseString

如果确认需求只是对一段已经确定方向的文本做字符顺序反转，可以退回 ReverseString；如果输入是字节切片并且需要追加到已有缓冲区，可以考虑 AppendReverse。这两者都应在函数名或注释中写清“反转字符”的意图，避免被误认为是双向排版入口。

告警确认与复盘项

修复后可以用三类可观测信息确认方向正确：输入消费字节数没有异常截断；段落方向符合实际文本组成；每个 run 的位置、方向和原文片段能够解释界面中的顺序。不要把“字符串看起来反过来了”作为唯一告警，它无法区分数据层、BiDi 分析层和最终渲染层。

还要注意两个生命周期约束。第一，在同一个 Paragraph 上再次调用 SetString 或 SetBytes 会让此前生成的 Ordering 失效；第二，官方文档要求一个 Ordering 的方法只由一个 goroutine 同时调用。若要并发处理，请为任务准备独立的输入与结果对象，而不是共享同一个排序结果。

当前官方文档还标注该包处于 under construction，API 可能发生不兼容变化。升级依赖时，应把这几个关键调用和混合方向样例作为回归清单，而不是只测纯英文或纯右向文本。

常见问题

只包含阿拉伯文时，能不能直接反转？

如果你真正需要的是字符顺序反转，可以使用 ReverseString；但如果目标是屏幕上的正确排版，仍应把文本交给段落级 BiDi 处理，并由渲染层完成最终布局。

为什么数字看起来没有跟着右向文字一起移动？

数字可能形成独立方向 run，标点还可能属于中性类别。整串反转无法表达这些类别之间的关系，应打印 Ordering 和每个 Run.Direction 再排查。

应该用 Order 还是 Line？

需要观察整段的视觉顺序用 Order；排版器已经确定一行的原文范围时用 Line。两者都依赖同一份原文位置定义。

能不能把 Ordering 缓存后给多个 goroutine 使用？

不要直接这样做。官方文档明确要求 Ordering 的方法一次只由一个 goroutine 调用；重新设置 Paragraph 还会使已有 Ordering 失效。

一句话复盘：右向文本不是“把字符串倒过来”，而是“先识别段落方向，再按 runs 计算视觉顺序”。