Go x/text/width LookupRune 怎样查询字符宽度属性

做中英文混排、终端表格或日志对齐时，直接用 len(string) 往往会把字节数、字符数和宽度属性混在一起。golang.org/x/text/width 提供的 LookupRune 解决的是“这个 Unicode 字符属于哪种宽度类别，以及有没有对应的宽窄变体”这一层问题。

最小用法是把一个 rune 传给 width.LookupRune，拿到 Properties 后再读取 Kind()。如果还要做规范化，可继续看 Wide()、Narrow() 和 Folded()；但它们不是终端像素宽度测量器。

先准备一个字符宽度检查器

这个小程序只做一件事：接收若干字符，逐个转成 rune，然后打印宽度属性。模块名和依赖版本应以项目自己的 go.mod 为准，不必把版本号硬编码进业务逻辑。

# 创建演示目录并初始化 Go module
mkdir width-checker
cd width-checker
go mod init example.com/width-checker
go get golang.org/x/text/width

输入字符串时要按 rune 遍历，而不是按字节下标切片。中文、全角符号和部分扩展字符都可能占用多个 UTF-8 字节。

LookupRune 返回的 Properties 怎么读

下面的代码用 LookupRune 查询三个有代表性的字符：拉丁字母、全角字母和中文。Kind() 是分类入口，其他方法是围绕宽窄映射的补充信息。

package main

import (
    "fmt"

    "golang.org/x/text/width"
)

func main() {
    samples := []rune{'A', 'Ａ', '中', '·'}

    for _, r := range samples {
        props := width.LookupRune(r)

        // Kind 用于读取 Unicode 宽度分类，不代表终端最终显示了几列。
        fmt.Printf("%q U+%04X kind=%s", r, r, props.Kind())
        // 变体方法返回可用的对应 rune；没有对应变体时返回 0。
        fmt.Printf(" wide=%U narrow=%U folded=%U\\n", props.Wide(), props.Narrow(), props.Folded())
    }
}

可以把 Properties 当成一次查询的只读结果。Wide() 返回宽版本，Narrow() 返回窄版本，Folded() 返回折叠后的规范形式；当字符已经处于对应形态或没有可用映射时，相关方法可能返回 0。因此生产代码要先判断返回值，再决定是否替换。

宽度属性与显示列宽不要混为一谈

Kind() 遵循 Unicode East Asian Width 的分类语义。它能帮助程序判断一个字符在东亚排版语境下偏向宽、窄、全角、半角或模糊，但它没有读取你的终端字体，也不会知道组合字符、emoji 序列或当前渲染器的列宽策略。

例如，EastAsianAmbiguous 表示字符在不同环境可能按宽或窄处理。日志对齐时，可以先用 Kind() 做分类，再由应用明确选择“中文环境按两列、拉丁环境按一列”的策略；不要把所有非 ASCII 字符简单乘以二。

批量扫描字符串时的四个检查点

如果要检查一整行文本，按 rune 遍历并保留原始字符串，属性只用于决策，不要直接覆盖输入。对 0 返回值、模糊宽度和组合字符分别留出策略，排查会比“看到中文就算两列”更稳定。

func inspect(s string) {
    for _, r := range s {
        props := width.LookupRune(r)

        // 先记录分类，真正的列宽计算交给上层排版策略。
        kind := props.Kind()
        narrow := props.Narrow()
        if narrow == 0 {
            // 没有窄变体时保留原字符，避免把 0 当成有效 rune。
            narrow = r
        }
        fmt.Printf("%U kind=%s narrow=%U\\n", r, kind, narrow)
    }
}

实际接入日志表格时，建议把“属性分类”和“显示列数”拆成两个字段：前者来自 LookupRune，后者由字体、渲染器、组合标记和产品规则共同决定。这样以后更换终端库，不会误改字符归一化逻辑。

常见问题

LookupRune 能直接返回字符占几列吗？

不能。它返回的是 Properties，重点是 Unicode 宽度属性和变体映射；终端列数需要额外的渲染规则。

为什么 Wide 或 Narrow 返回 0？

这通常表示没有可用的对应变体，或者当前字符已经处在目标形态。调用方应保留原 rune，而不是把 0 写回字符串。

LookupRune 和 LookupString 有什么区别？

LookupRune 直接查询一个 rune；LookupString 从字符串首个 rune 开始查询，并额外返回该 rune 的 UTF-8 字节长度。已经完成 rune 遍历时，前者更直接。

把 LookupRune 放在“字符属性查询”这一层，后面再接应用自己的列宽与渲染策略，边界会清楚很多：Unicode 分类负责描述字符，排版系统负责决定怎么显示。