Go 命令行表格怎么按列对齐输出

Go 命令行表格如果靠 fmt.Printf 手工补空格，字段一变长就会错位。标准库 text/tabwriter 的做法更稳：把每个单元格用制表符写入同一个 Writer，它根据连续行的列宽补齐空白，最后调用 Flush() 输出。下面这套写法适合状态表、配置摘要和诊断命令。

用制表符把数据交给 tabwriter

tabwriter.Writer 处理的是“带制表符的文本”，不是结构化表格对象。每一行把字段写成 字段1\t字段2\t字段3\t，连续行中相同位置的单元格就会形成列。最后一列如果也写入制表符，tabwriter 才能把它纳入列宽计算；没有终止制表符的行尾文本会被当作普通尾部内容。

package main

import (
    "fmt"
    "log"
    "os"
    "text/tabwriter"
)

func main() {
    // 使用空格填充，让输出在常见终端里更容易直接阅读。
    w := tabwriter.NewWriter(os.Stdout, 0, 0, 1, ' ', 0)

    // 每个字段后写入制表符，最后一列也保留列终止边界。
    fmt.Fprintln(w, "服务\t状态\t延迟\t")
    fmt.Fprintln(w, "gateway\tready\t18ms\t")
    fmt.Fprintln(w, "worker-long-name\tdegraded\t240ms\t")

    // Writer 内部要等后续行确定列宽，结束时必须把缓冲内容写出。
    if err := w.Flush(); err != nil {
        log.Fatal(err)
    }
}

这里没有计算最长服务名，也没有给每一列写固定数量的空格。新增一行只会让 tabwriter 重新按输入文本计算列宽。若底层输出是文件、管道或网络 writer，Flush 返回的错误也应继续向调用方传递，而不是无视。

NewWriter 参数怎么选才不容易错位

NewWriter 的参数顺序比较紧凑，真正容易混淆的是“终端制表位宽”和“单元格之间的额外间距”。可以先按下面的速查表选择：

例如日志摘要更适合空格填充；需要看清列边界时，可以临时加入 tabwriter.Debug，让输出显示竖线。这个标志主要用于排查列是否连续，不建议把调试符号当成正式输出格式。对于数字列，整体使用 AlignRight 会更像报表，但字段含义要一致，不能把状态文字和数值混在同一列。

Flush 和尾部制表符决定输出边界

Writer 会缓冲输入，因为前一行的列宽可能要等后续行才知道。因此只写 fmt.Fprintln(w, ...) 还不算完成，函数返回前要调用 Flush()。如果输出 writer 可能失败，应检查这个返回值。

另一个常见坑是可选字段。假设某行没有“备注”列，直接写成 名称\t状态，这一行的尾部就不再参与完整列对齐；更稳的办法是仍写出空单元格，例如 名称\t状态\t\t。如果确实需要丢弃由软制表符形成的空列，可以了解 DiscardEmptyColumns，但不要把它当成补齐缺失字段的通用方案。

中文和机器输出不要交给同一个假设

tabwriter 按 UTF-8 文本处理输入，并默认每个 Unicode code point 占用相同宽度。实际终端里中文通常占两个显示单元，组合字符也可能改变视觉宽度，所以“程序认为对齐”不一定等于“字体看起来对齐”。如果表格主要给人看，可以在目标终端和字体下抽查；如果输出要被脚本解析，则不要依赖补空格，优先使用 JSON、CSV 或明确的分隔协议。

同理，HTML 标签和实体只有在设置 FilterHTML 后才会按特殊宽度处理；普通命令行状态表不需要打开它。把颜色控制符直接塞进单元格也可能让视觉宽度判断失真，最好把机器输出和带颜色的人读输出分开。

常见问题

为什么表格最后一列没有对齐？

通常是最后一列没有以制表符终止，行尾文本不会成为连续对齐列。给每行最后一个字段补上 \t，再调用 Flush。

tabwidth 和 padding 有什么区别？

tabwidth 描述制表位的宽度，padding 是单元格旁额外留出的间隔。使用空格作为填充字符时，通常先调整 padding；使用制表符输出时再重点确认 tabwidth 与查看器设置一致。

能不能用 tabwriter 生成 CSV？

不建议。tabwriter 面向人读的对齐文本，会插入填充；CSV 需要字段转义、分隔和换行规则，应该使用 encoding/csv。两者解决的是不同的输出问题。

命令行表格的稳定写法可以浓缩成一句话：字段用制表符描述，格式参数按阅读场景选择，最后检查 Flush() 和字符宽度边界。