Go x/text/width 宽度分类为什么不能直接当屏幕像素宽度

先给结论：golang.org/x/text/width 的“宽度”是 Unicode 规范里的字符属性分类，不是字体渲染后的屏幕像素宽度。width.Kind 可以告诉你一个 rune 更接近宽字符、窄字符、全角、半角还是需要上下文判断的模糊宽度，但它不会返回 8px、16px 这样的测量值。

官方文档：https://pkg.go.dev/golang.org/x/text/width

因此，终端对齐、表格列宽和网页布局不能只拿 Kind 相加。先确认你要的是字符分类、字符规范化、UTF-8 字节长度，还是某种字体下的实际布局宽度，再选择 API。

width.Kind 表示的是 Unicode 宽度属性

width 包的定义来自 Unicode Technical Standard #11。它描述的是字符在东亚排版、换行和竖排场景中的宽窄倾向，常量包括 Neutral、EastAsianAmbiguous、EastAsianWide、EastAsianNarrow、EastAsianFullwidth 和 EastAsianHalfwidth。

这里有三个容易混在一起的概念：

例如，两个字符都可能被分类为“宽”，但换一套字体、字号或渲染引擎后，实际 advance width 仍可能不同；EastAsianAmbiguous 更不能被硬编码成永远一列或永远两列。

用 LookupRune 读取分类，而不是计算像素

当输入已经是一个 rune 时，用 width.LookupRune 取得 Properties，再调用 Kind()。如果输入是 UTF-8 字节或字符串，Lookup、LookupString 还会返回首个 rune 的 UTF-8 编码字节数；这个返回值服务于切分输入，不是显示宽度。

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: kind=%s wide=%q narrow=%q\n", r, props.Kind(), props.Wide(), props.Narrow())
    }

    text := "中A"
    props, size := width.LookupString(text)
    // size 表示首个 rune 的 UTF-8 字节数，不能当成屏幕列宽。
    fmt.Printf("first=%s utf8-bytes=%d\n", props.Kind(), size)
}

Properties.Wide 和 Properties.Narrow 也只是查询可用的兼容变体：没有对应变体时会返回 0。它们适合做字符关系判断或后续变换，不代表把字符送进布局引擎后一定得到某个像素宽度。

Fold、Narrow、Widen 是字符变换，不是布局测量

如果目标是统一全角与半角形式，可以使用 width.Fold、width.Narrow 或 width.Widen。这些 Transformer 会返回变换后的字符串；官方示例也展示了全角拉丁字母、半角片假名等字符如何被映射。变换改变的是码点序列，不能替代指定字体环境下的排版测量。

package main

import (
    "fmt"

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

func main() {
    input := "ＡＢＣ ｦ"
    folded := width.Fold.String(input)
    narrowed := width.Narrow.String(input)
    widened := width.Widen.String("ABC")

    // 这些结果用于字符规范化；它们没有返回像素或字体 advance width。
    fmt.Println("folded:", folded)
    fmt.Println("narrowed:", narrowed)
    fmt.Println("widened:", widened)
}

如果你需要“字符串在终端占几列”，还要结合终端采用的 East Asian Width 策略、控制字符、组合字符和 emoji 规则；如果你需要网页或桌面界面的像素宽度，则应把字符串交给目标字体和布局引擎测量。不要用 len(s)、utf8.RuneCountInString(s) 或 Kind() 的数量直接代替这两类结果。

按实际目标选择正确的宽度方案

可以用下面的决策顺序排查“宽度不对”：

• 只想识别全角、半角或东亚宽度属性：用 LookupRune 与 Properties.Kind。
• 想把字符规范化为窄体、宽体或折叠形式：用 width.Narrow、width.Widen 或 width.Fold，并接受码点会变化。
• 想知道字符串占多少 UTF-8 存储空间：按字节处理，必要时使用 LookupString 或 UTF-8 相关 API。
• 想计算网页、桌面控件或图片中的实际像素：使用目标字体、字号和布局环境的测量接口，不能只依赖 x/text/width。

特别要注意模糊宽度。EastAsianAmbiguous 的最终显示倾向需要排版环境提供额外信息，单凭字符码点无法得到统一的屏幕宽度。把它强制当作固定两列，可能在西文环境和东亚环境之间产生不同的对齐结果。

几个容易混淆的问题

width.Kind 能不能直接换算成 1 或 2 列？

不能。它提供分类线索，不提供终端实现的完整列宽规则；组合字符、控制字符和模糊宽度还需要由具体输出环境决定。

UTF-8 占 3 个字节，是不是显示宽度就是 3？

不是。UTF-8 字节数是编码存储属性，显示宽度由字符类别、字体和布局规则共同决定。

把字符串先 Fold 再测量可以吗？

可以作为业务明确要求的规范化步骤，但要把它当成“改变输入后再测量”，不能把 Fold 的结果当作原字符串天然的像素宽度。

总结一下：golang.org/x/text/width 解决的是 Unicode 宽度属性与全半角变换；屏幕像素宽度属于字体和布局环境。先明确目标，再分别使用分类 API、字符 Transformer、字节统计或实际布局测量，才能避免“分类值等于像素值”的误判。