Go go-pretty 的 RowPainter 怎样影响行颜色

Go 使用 github.com/jedib0t/go-pretty/v6/table 输出终端表格时，如果想让某一整行根据状态变色，入口就是 SetRowPainter。它接收一个行绘制回调，回调拿到 table.Row 后返回 text.Colors；返回的颜色用于整行，而不是只改某个单元格。

官方地址：https://pkg.go.dev/github.com/jedib0t/go-pretty/v6/table

这条关系很适合放在服务列表、批处理结果或命令行巡检表里：行内容负责决定颜色，表格 Writer 负责把颜色应用到渲染结果。下面从最小回调开始，再处理排序后的行号和颜色优先级。

RowPainter 的输入与整行颜色返回

官方 API 将 RowPainter 定义为接收一个 table.Row、返回一个 text.Colors 的函数类型。text.Colors 本身是一组颜色对象，可以同时放入前景色、背景色或文字属性。回调不需要重新拼接行内容，也不负责绘制边框。

因此，先把职责压缩成一句话：RowPainter 只回答“这行应该用什么颜色”，table.Writer 继续处理列宽、边框、排序和输出格式。这个边界在表格变大时更容易维护，因为业务判断不会散落到每个单元格配置里。

按行内容选择颜色

最常见的做法是约定某一列表示状态，再把它转换成字符串进行分支。示例把第三列作为状态列；如果状态列可能缺失，先判断行长度，避免回调因为越界破坏整张表的输出。

package main

import (
    "fmt"

    "github.com/jedib0t/go-pretty/v6/table"
    "github.com/jedib0t/go-pretty/v6/text"
)

// paintRow 只决定整行颜色，不修改行数据和列布局。
func paintRow(row table.Row) text.Colors {
    // 状态列约定为第三列；缺列时保持 Writer 的默认颜色。
    if len(row) 

这里的关键不是颜色常量，而是返回值的范围：text.Colors 代表整行的颜色集合。返回 nil 可以让没有命中规则的行继续使用默认样式；不要把“没有特殊颜色”误写成一个会覆盖列级样式的空配置。

把回调安装到 Writer

SetRowPainter 会保存这个函数，并在渲染前针对各行确定颜色。官方说明还特别指出，RowPainter 决定的颜色优先于 ColumnConfig 的颜色设置以及其他列级颜色方法。这意味着它适合表达整行状态，不适合拿来做单个字段的细粒度格式化。

在规模较小的表里，可以直接使用一个命名函数；在多个表共用规则时，建议把状态到颜色的映射抽成独立函数，再为不同表提供列位置或字段结构转换。这样做的取舍是：回调更稳定，但业务数据需要先整理成清晰的行契约。

按排序位置处理颜色

如果颜色规则依赖“当前排序后的第几行”，只使用 table.Row 就不够了。当前版本文档还提供 RowPainterWithAttributes，在行之外传入 RowAttributes；其中 Number 是追加时的 1-based 行号，NumberSorted 是排序后的 1-based 位置。

例如，排序后想做斑马纹，可以读取 NumberSorted，而不是读取追加顺序。下面的回调在偶数排序位置返回浅色背景，奇数位置返回 nil，让默认样式负责另一种行。

package main

import (
    "fmt"

    "github.com/jedib0t/go-pretty/v6/table"
    "github.com/jedib0t/go-pretty/v6/text"
)

func main() {
    writer := table.NewWriter()
    writer.AppendHeader(table.Row{"服务", "延迟"})
    writer.AppendRows([]table.Row{
        {"cache", 40},
        {"api", 120},
        {"worker", 80},
    })
    // 排序规则决定 NumberSorted 的语义，先按延迟升序排列。
    writer.SortBy([]table.SortBy{{Name: "延迟", Mode: table.AscNumeric}})
    writer.SetRowPainter(func(row table.Row, attr table.RowAttributes) text.Colors {
        // 使用排序后位置做斑马纹，不把追加顺序当成显示顺序。
        if attr.NumberSorted%2 == 0 {
            return text.Colors{text.BgHiBlack, text.FgWhite}
        }
        // 返回 nil，让奇数行继续使用当前默认样式。
        return nil
    })
    fmt.Print(writer.Render())
}

这段代码表达的是 API 关系和选择逻辑，不把某个终端的颜色输出当作固定结果。颜色是否真正显示还取决于终端能力、环境变量和 text 包的颜色开关；输出到 CSV、TSV 等非彩色格式时，也不应把 ANSI 颜色当成数据字段。

颜色优先级与常见边界

当列配置和行回调同时存在时，优先级是最容易误判的地方。可以按下面的顺序做设计：状态导致的整行告警交给 RowPainter；单列的语义强调交给 ColumnConfig；没有特殊状态时返回 nil，不要用默认颜色把列配置覆盖掉。

• 状态列缺失：先判断 len(row)，缺少字段时返回 nil 或记录数据契约问题。
• 排序后的交替色：使用 NumberSorted；需要追溯输入顺序时再看 Number。
• 多种颜色叠加：text.Colors 是颜色切片，顺序表达组合，不要把它误当成单个颜色值。
• 禁用颜色：允许终端或环境关闭颜色，业务字段不能依赖颜色才能被理解，最好保留“failed”“warning”等文字。
• 不同输出格式：RowPainter 解决的是 table 的颜色样式，不会替 CSV、Markdown 或业务导出协议增加状态字段。

如果同一份数据既要输出终端表格又要输出机器可读格式，建议把状态判断抽成无副作用函数：终端渲染层把结果映射成 text.Colors，导出层保留原始状态文本。这样不会把展示规则反向写进数据模型。

小结：什么时候该用 RowPainter

需要让“这一行整体表达一种状态”时，用 SetRowPainter 最直接；需要依赖排序后位置时，改用带 RowAttributes 的回调；只强调单个字段时，保留列级颜色配置。真正的边界在于优先级：RowPainter 返回的颜色会覆盖列级颜色，所以未命中规则时返回 nil 往往比返回一个默认颜色更安全。

RowPainter 能只修改一列吗？

它返回的是应用于整行的 text.Colors，不能把它当作单列着色器。只改一列应使用列配置或单元格内容转换。

为什么排序后斑马纹会错位？

如果用追加时的 Number 计算颜色，排序后颜色仍跟着原始位置走。使用 RowPainterWithAttributes 并读取 NumberSorted，才能按当前显示位置判断。

返回 nil 会不会清除列颜色？

它表示当前行没有额外的 RowPainter 颜色，让默认样式或其他配置继续参与。若规则要求某些行必须整行覆盖，则只在命中分支返回具体的 text.Colors。

参考资料：https://pkg.go.dev/github.com/jedib0t/go-pretty/v6/table、https://pkg.go.dev/github.com/jedib0t/go-pretty/v6/text。