golang 的 text/tabwriter 库可通过识别 tab 字符对齐文本,适合格式化表格类数据。1. 创建 tabwriter 实例并写入 tab 分隔的数据;2. 配置参数包括 minwidth、tabwidth、padding、padchar 和 flags;3. 必须调用 flush() 才能输出结果;4. 注意避免字段中混入 tab、保持字段类型一致,并可开启 debug 模式辅助调试。

Golang 的 text/tabwriter 库可以很方便地对齐文本,特别适合用来格式化输出表格类数据。它通过识别 tab 字符(\t)来自动对齐列内容,并支持多种格式控制选项。

基本用法:创建 TabWriter 并写入数据
使用 tabwriter.NewWriter 创建一个 TabWriter 实例后,就可以像普通 io.Writer 一样写入带 tab 分隔的数据。每个 tab 表示一列,TabWriter 会根据所有行的内容自动调整每列的宽度,使它们对齐。

w := tabwriter.NewWriter(os.Stdout, 0, 0, 2, ' ', 0) fmt.Fprintln(w, "Name\tAge\tCity") fmt.Fprintln(w, "Alice\t30\tNew York") fmt.Fprintln(w, "Bob\t25\tLos Angeles") w.Flush()
上面的例子中:
立即学习“go语言免费学习笔记(深入)”;
-
os.Stdout表示输出到控制台; - 后面几个参数分别是:最小空格数、最大 tab 宽度、填充字符等(后面细说);
- 每行用
\t分隔不同字段; - 最后调用
Flush()才真正输出结果。
配置参数说明与建议
tabwriter.NewWriter 的完整定义如下:

func NewWriter(output io.Writer, minwidth, tabwidth, padding int, padchar byte, flags uint) *Writer
常用的配置项解释如下:
- minwidth:最小列宽,通常设为 0 即可;
- tabwidth:一个 tab 对应多少个空格,默认是 8,但通常设置成实际显示效果更合理的值,比如 4 或者 2;
- padding:列之间的额外间距;
-
padchar:填充字符,通常是
' '(空格); -
flags:格式标志位,常见有:
-
tabwriter.AlignRight:右对齐; -
tabwriter.Debug:调试模式,显示边框线; -
tabwriter.TabIndent:第一个 tab 前加空格; - 多个标志可以用
|组合使用。
-
例如开启右对齐和调试模式:
w := tabwriter.NewWriter(os.Stdout, 0, 4, 1, ' ', tabwriter.AlignRight|tabwriter.Debug)
使用技巧与注意事项
必须调用 Flush()
TabWriter 是缓冲写入的,不调用Flush()数据不会被写入底层 Writer。避免在字段里混入 tab 字符
如果某个字段本身包含\t,会导致排版错乱。可以在写入前做预处理,比如替换掉或者限制输入内容。字段尽量保持一致类型,方便对齐
比如全是字符串或全是对齐方式一致的数字。否则可能出现某些列看起来不对齐的情况。调试时可以打开 Debug 标志
有助于查看各列边界是否正确。
示例输出效果对比
假设我们有以下三行数据:
Name Age City Alice 30 New York Bob 25 Los Angeles
默认情况下,TabWriter 会以左对齐的方式输出;如果加上 AlignRight 标志,则每一列都会靠右对齐,数值型字段会更清晰:
Name Age City
Alice 30 New York
Bob 25 Los Angeles基本上就这些。合理使用 text/tabwriter 能让命令行下的表格输出更整洁易读。










