Go go-pretty 怎样按多列规则排序表格行

如果表格要先按状态、再按优先级、最后按更新时间排序，go-pretty/table 的做法是把多个 table.SortBy 按业务优先级放进同一个切片，再交给 tw.SortBy。前一列相等时才会比较后一列，所以切片顺序就是排序规则的优先级。

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

我在实际整理命令行表格时，最容易犯的错不是不会调用 SortBy，而是把数字列当成普通文本，或者把“主要排序条件”和“兜底条件”写反。下面用一个任务列表把这几个点串起来。

先把用户真正关心的顺序写出来

假设表格展示待办任务，产品要求是：未完成任务优先；同一状态下优先级高的在前；优先级也相同，再按更新时间新的在前。对应到代码就是三列排序：

package main

import (
    "fmt"

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

func main() {
    tw := table.NewWriter()
    tw.AppendHeader(table.Row{"任务", "状态", "优先级", "更新时间"})
    tw.AppendRows([]table.Row{
        {"补充文档", "进行中", 2, "2026-10-30 09:20"},
        {"修复登录", "待处理", 1, "2026-10-30 10:05"},
        {"升级依赖", "待处理", 3, "2026-10-30 08:40"},
        {"整理日志", "进行中", 2, "2026-10-30 11:10"},
    })

    // 排序切片从左到右表达主次：状态相同才比较优先级。
    tw.SortBy([]table.SortBy{
        {Name: "状态", Mode: table.Asc},
        {Name: "优先级", Mode: table.DscNumeric},
        {Name: "更新时间", Mode: table.Dsc},
    })

    // Render 只负责呈现；排序规则已经绑定在 Table Writer 上。
    fmt.Println(tw.Render())
}

这里的关键不是三行配置本身，而是它们的相对位置。第一条规则没有区分出两行时，比较器继续看第二条；第二条仍然相等，才会进入第三条。换句话说，SortBy 切片更像一张“业务优先级表”，不要按字段在结构体里的出现顺序随意排列。

数字列要明确使用 Numeric 模式

table.Row 中的值最终会参与表格排序比较。对于“1、2、10”这类内容，如果按普通字母序比较，10 可能排在 2 前面；优先级、数量、端口和重试次数这类字段，应该使用数字模式。

package main

import (
    "fmt"

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

func main() {
    tw := table.NewWriter()
    tw.AppendHeader(table.Row{"服务", "重试次数", "名称"})
    tw.AppendRows([]table.Row{
        {"api", "10", "gateway"},
        {"worker", "2", "batch"},
        {"cron", "1", "cleanup"},
    })

    // 字符串数字也要声明数字语义，否则容易得到字典序。
    tw.SortBy([]table.SortBy{
        {Name: "重试次数", Mode: table.AscNumeric},
        {Name: "名称", Mode: table.Asc},
    })

    // Render 输出排序后的表格文本。
    fmt.Print(tw.Render())
}

常用模式可以这样选：

如果数据来自 JSON、CSV 或命令行参数，字段常常已经是字符串。不要因为“看起来是数字”就默认它会按数值排序，最好在 SortBy 中明确写出 Numeric 模式。

列名和列号怎么选

SortBy 有两种定位方式：用 Name 指向表头名称，或用 Number 指向从左到右的列号。表头稳定、阅读性优先时，列名更直观；表头可能省略、由外部配置生成，或者你需要绑定固定列位置时，列号更稳。

package main

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

func sortWithStableColumn(tw table.Writer) {
    // 有明确表头时，Name 让排序规则和业务字段同名，维护成本较低。
    tw.SortBy([]table.SortBy{
        {Name: "状态", Mode: table.Asc},
        {Name: "优先级", Mode: table.DscNumeric},
    })
}

func sortWithFixedPosition(tw table.Writer) {
    // 没有可靠表头时，Number 使用从左到右的列号；Number 会优先于 Name。
    tw.SortBy([]table.SortBy{
        {Number: 2, Mode: table.DscNumeric},
        {Number: 1, Mode: table.Asc},
    })
}

使用 Name 时，表头名称必须和排序规则一致；名称找不到时，该规则不会按预期生效。使用 Number 时，要把列插入、隐藏或重排纳入维护约定。我的经验是：面向人维护的固定报表用 Name，面向机器生成的稳定列协议用 Number，不要在同一规则里同时依赖两套含义。

大小写和自定义规则要单独处理

文本排序默认会区分大小写。如果产品只关心名称的字母顺序，可以给对应的 SortBy 设置 IgnoreCase: true。这只影响该列，不会自动改变其它列。

package main

import (
    "strings"

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

func addNameSort(tw table.Writer) {
    // 忽略大小写后，API、api 和 Api 按同一字母序比较。
    tw.SortBy([]table.SortBy{
        {Name: "名称", Mode: table.Asc, IgnoreCase: true},
    })
}

func addStatusSort(tw table.Writer) {
    // 自定义比较器接收已经转成字符串的单元格值，并返回 -1、0 或 1。
    tw.SortBy([]table.SortBy{
        {
            Name: "状态",
            CustomLess: func(left, right string) int {
                rank := map[string]int{"待处理": 0, "进行中": 1, "已完成": 2}
                l, lok := rank[strings.TrimSpace(left)]
                r, rok := rank[strings.TrimSpace(right)]
                // 未识别状态放在已知状态之后，避免默认为最高优先级。
                if !lok {
                    l = len(rank) + 1
                }
                if !rok {
                    r = len(rank) + 1
                }
                switch {
                case l  r:
                    return 1
                default:
                    return 0
                }
            },
        },
    })
}

CustomLess 适合“待处理、进行中、已完成”这种业务顺序，也适合把带单位的字符串映射为可比较的等级。它有三个容易忽略的边界：

• 比较函数拿到的是字符串，而不是原始的整数、时间或结构体，需要自行解析或映射。
• 返回负数、零、正数分别表示左值更靠前、相等、右值更靠前；保持这个契约，才能让多列规则继续工作。
• 设置 CustomLess 后，该列会忽略 Mode 和 IgnoreCase，不要以为两者会叠加。

把排序和过滤、渲染职责分开

go-pretty 同时提供 FilterBy 和 SortBy，但它们解决的是两个不同问题：过滤决定哪些行保留，排序决定保留下来的行如何排列。官方说明中，过滤会先于排序应用，因此不要把“只显示高优先级任务”误写成一个复杂的排序比较器。

package main

import "github.com/jedib0t/go-pretty/v6/table"

func configureTable(tw table.Writer) {
    // 过滤条件表达保留哪些行，排序条件表达这些行的显示优先级。
    tw.FilterBy([]table.FilterBy{
        {Name: "状态", Operator: table.NotEqual, Value: "已归档"},
    })
    tw.SortBy([]table.SortBy{
        {Name: "状态", Mode: table.Asc},
        {Name: "优先级", Mode: table.DscNumeric},
    })
}

在代码评审时，我通常按三个问题检查：

1. 第一条规则是不是读者真正关心的主排序条件？
2. 数字列是否用了 Numeric 模式，日期是否使用了可比较的统一表示？
3. 自定义状态顺序是否覆盖未知值、空值和拼写差异？

几个经常出现的边界

相同值怎么稳定排序

如果所有 SortBy 规则都比较为相等，库没有额外的业务主键可以替你决定顺序。需要稳定展示时，可以再加一个唯一或近似唯一的兜底列，例如任务编号或创建时间。

日期和时间不要直接依赖展示格式

如果更新时间显示为“10月30日 09:00”，它更适合阅读，不一定适合比较。可以把可排序的时间戳放在数据列中，或者用 CustomLess 把统一格式的字符串解析成可比较值，再决定是否隐藏辅助列。

表头变化会影响 Name

如果国际化、动态列或自定义标题会改变表头文本，基于 Name 的规则就需要同步更新；这时应考虑列号、稳定字段映射或在组装表头时建立固定契约。

一张决策表

结语

Go go-pretty 的多列排序可以归结为一句话：先把业务优先级排成 SortBy 切片，再为每一列选择正确的比较模式。状态顺序用 CustomLess，数量和级别用 Numeric，名称排序再决定是否忽略大小写；最后补一个稳定的兜底字段，表格的结果就更容易解释和维护。

相关问题

go-pretty 的 SortBy 可以同时按升序和降序吗？

可以。每个 table.SortBy 独立设置 Mode，例如第一列用 Asc，第二列用 DscNumeric。

为什么优先级 10 会排在优先级 2 前面？

通常是因为把数值当作普通文本比较了。将该列改为 AscNumeric 或 DscNumeric，并确认单元格内容能够被解析为数字。

CustomLess 能和 IgnoreCase 一起使用吗？

可以同时写在结构体里，但自定义比较器会覆盖该列的默认 Mode 和 IgnoreCase 逻辑。需要忽略大小写时，请在 CustomLess 内自行统一大小写。