Go go-runewidth 怎样按显示列数折行

Go go-runewidth 可以用 runewidth.Wrap(text, columns) 按显示列数插入换行。需要固定宽度策略时，创建独立的 Condition，使用 cond.Wrap 折行，并用同一个 Condition 的 StringWidth 计算每行宽度。它按终端单元格估算宽度，不能用 len 或 rune 数量替代，也不是浏览器像素排版器。

官方地址：https://github.com/mattn/go-runewidth

用显示列数定义排版目标

命令行摘要既有 ASCII，也有中文时，len 得到的是 UTF-8 字节数，rune 数量也未必等于占用的显示列数。常见中文字符通常占两列，而 ASCII 字母通常占一列；组合字符与 emoji 序列还需要更细的处理。

这里要保护的是可读的文本列宽与稳定的显示内容：外部输入既可能很长，也可能带有控制字符。宽度计算只解决其中的排版问题，不会自动让输入成为安全的终端文本。把纯文本字段和带样式的终端内容区分开，调用规则会更明确。

创建独立 Condition 并折行

下面封装一个有限长度的纯文本字段，固定 EastAsianWidth 与 StrictEmojiNeutral，再按六列折行。应用对列数、长度及控制字符作出额外限制，这些限制属于本例的输入契约，不是库的默认保证。

package main

import (
    "fmt"
    "strings"
    "unicode"
    "unicode/utf8"

    "github.com/mattn/go-runewidth"
)

// WrapPlain 面向短小的纯文本字段；保留换行，拒绝其他控制字符。
func WrapPlain(s string, columns int) (string, error) {
    if columns  200 {
        return "", fmt.Errorf("列数必须在 2 到 200 之间")
    }
    if len(s) > 64*1024 || !utf8.ValidString(s) {
        return "", fmt.Errorf("输入过长或不是有效 UTF-8")
    }
    // 统一行结束；单独的回车和制表符仍由后续规则拒绝。
    s = strings.ReplaceAll(s, "\r\n", "\n")
    for _, r := range s {
        if r != '\n' && unicode.IsControl(r) {
            return "", fmt.Errorf("纯文本字段不接受控制字符")
        }
    }
    cond := runewidth.NewCondition()
    cond.EastAsianWidth = false // 固定歧义宽度策略，避免依赖当前 locale。
    cond.StrictEmojiNeutral = true
    return cond.Wrap(s, columns), nil
}

func main() {
    text, err := WrapPlain("AB中文CD测试", 6)
    if err != nil {
        panic(err) // 示例入口不继续显示被拒绝的输入。
    }
    cond := runewidth.NewCondition()
    cond.EastAsianWidth = false
    cond.StrictEmojiNeutral = true
    for _, line := range strings.Split(text, "\n") {
        // %q 用转义形式展示，列宽由同一套策略计算。
        fmt.Printf("%q columns=%d\n", line, cond.StringWidth(line))
    }
}

按普通 ASCII 与中文宽度规则手工推算，AB中文 占六列，CD测试 也占六列，因此本例应在“文”和“C”之间插入换行。这里说明的是规则推导，本文没有运行示例，也没有生成终端截图。

Wrap 保留既有换行，并在超过指定显示列数时添加换行；它属于硬折行，不会承诺按英文单词边界或中文标点禁则排版。当前接口见Condition.Wrap 文档。

通过独立 Condition 固定配置，比在请求处理中反复修改全局 DefaultCondition 更容易控制。示例的 false 表示把东亚歧义宽度策略固定为非宽模式；这不等于把所有中文变成一列。实际终端对某些字符的显示可能仍与估算不同。

为外部文本设置输入约定

本例允许 LF 换行，将 CRLF 统一为 LF，拒绝其他 unicode.IsControl 判定的控制字符。因此制表符、独立回车和 ESC 都不会直接进入显示字符串。这是纯文本策略，不是一个完整 ANSI 解析器，也不声称过滤了所有不可见字符或双向文本控制影响。

不要把包含 ANSI 颜色和游标移动指令的原始字符串直接交给 Wrap，再假设其计数就是实际屏幕占位。控制序列中的普通字符可能被计入宽度，折行也可能破坏序列。对于带样式输出，应选择能识别样式序列的折行方案，或在可靠的样式层之外维护纯文本布局。

同样，Tab 的显示距离取决于当前位置和终端制表位，不是简单的固定 rune 宽度。本例选择拒绝，若业务需要 Tab，应先定义展开策略再折行。

记录宽度策略与逐行结果

诊断时记录库版本、列数、Condition 配置和输入字节长度即可；有隐私的文本不应完整写入日志。需要展示可疑内容时，可以用转义表示，避免原始控制字符直接改变查看日志时的终端状态。

每行宽度要逐行计算，不要对包含多行的整个字符串调用 StringWidth 后，把结果当作最长行宽。示例按换行拆开后计算，折行和测量采用相同配置。对于复杂 emoji、组合字符与字体回退，库结果仍是估算，应以目标显示环境的约定解释差异。

也不要从“使用 Wrap”推出任意宽度下每行都能严格不超限。如果单个不可拆的显示单元比目标列数更宽，保留字符与严格列宽会发生冲突。应在业务层决定拒绝、替换、截断还是允许该行超宽。本例至少要求两列，但没有宣称覆盖所有 Unicode 宽度异常。

区分硬折行与完整排版需求

Wrap 会自动补空格让每行一样宽吗？不会。折行只插入换行，补齐需要另外的填充策略。窄行不代表计算错误。

按字节切片再折行可以吗？不建议。任意字节位置可能切断 UTF-8 编码，应先保持有效文本，再按显示宽度处理。

为什么不能把 columns 设置成零？零没有正常可用的内容宽度含义。调用方应先拒绝无效配置，而不是依赖库在非正宽度下的边缘行为。

适合网页正文自动换行吗？网页排版取决于字体、字号、容器像素宽度和浏览器规则，go-runewidth 的终端列模型不直接适用。

实际接入时，先约定纯文本、宽度策略和输入规模，再使用 Condition.Wrap 与逐行 StringWidth。对样式控制、单词排版和复杂显示环境另作选择，才能让列宽计算承担清楚且有限的职责。实现细节可参考项目宽度与折行实现。