直接用 github.com/olekukonko/tablewriter 是最稳的选择，因其按 rune 计宽、自动适配终端、支持 UTF-8、可导出 CSV/Markdown，避免 fmt 手动拼接导致的中文错位、越界 panic 和管道崩溃等问题。
Go 语言本身不带命令行表格渲染库，fmt 或 strings.Join 手动拼接容易错位、不兼容中文、不响应终端宽度——直接用 github.com/olekukonko/tablewriter 是最稳的选择。
为什么不用 fmt.Printf 拼接表格
手动对齐列宽要算 rune 长度（尤其中文），还要处理换行、截断、空值；fmt.Printf("%-10s %-5d", name, age) 在含中文时会错乱，因为 %-10s 按字节计宽，而一个中文字符占 3 字节但显示占 2 个字符位置。终端缩放或管道输出（如 ./app | head）时还会崩溃。
常见错误现象：
-
panic: runtime error: index out of range（切片越界，因按字节截字符串） - 列头和数据明显右偏，尤其 macOS Terminal 或 Windows Terminal 中文环境
- 导出到文件后 Excel 打开列全挤在 A 列
tablewriter 基础用法：写死数据 + 自动对齐
它按 rune 计宽、自动适配终端、支持 UTF-8、可导出 CSV/Markdown。安装：go get github.com/olekukonko/tablewriter
立即学习“go语言免费学习笔记（深入）”；
关键点：
- 用
tablewriter.NewWriter(os.Stdout)初始化，别传nil或自定义io.Writer后忘了调Render() -
SetHeader([]string{"Name", "Age", "City"})必须在Append()前调用 - 中文列宽自动计算，无需手调
SetColumnWidth()—— 除非你明确要限制某列最大显示长度
package main
import (
"os"
"github.com/olekukonko/tablewriter"
)
func main() {
table := tablewriter.NewWriter(os.Stdout)
table.SetHeader([]string{"姓名", "年龄", "城市"})
table.Append([]string{"张三", "28", "北京"})
table.Append([]string{"山田太郎", "31", "东京"})
table.Render() // 必须调用！否则无输出
}
动态列宽与导出格式切换
默认行为是「内容自适应」，但遇到超长字段（如 JSON 片段）会撑爆终端。这时用 SetAutoWrapText(false) + SetColMinWidth(20) 更可控。
导出非终端格式时：
- CSV：
table.SetOutput(csvFile)+table.Render()，注意先csvFile, _ := os.Create("out.csv") - Markdown：
table.SetFormat(tablewriter.TABLE_FORMAT_MARKDOWN) - 无边框纯文本：
table.SetBorder(false)+table.SetColumnSeparator("")
性能影响：开启 SetAutoFormatHeaders(true)（默认）会把表头转大写+加下划线，CLI 工具一般关掉更干净：table.SetAutoFormatHeaders(false)。
和 tabwriter.StdWriter 的区别在哪
text/tabwriter 是 Go 标准库，轻量但能力弱：不识别中文宽度、不支持合并单元格、不自动换行、无表头样式。它适合日志对齐等简单场景，比如 go list -f '{{.ImportPath}}\t{{.Dir}}' 这类固定分隔符输出。
选 tablewriter 的真实理由：
- 需要表头居中、数据右对齐（
SetAlignment(tablewriter.ALIGN_CENTER)） - 要支持颜色（配合
github.com/fatih/color，把字符串包进color.GreenString("✅")再传给Append()） - 用户可能重定向输出（
./cli users > out.txt），需自动检测是否为终端并关闭颜色/动画
真正容易被忽略的是：当程序被管道调用时，os.Stdout 不再是终端，tablewriter 不会自动降级——得自己用 isatty.IsTerminal(os.Stdout.Fd()) 判断，并手动关掉颜色、边框、自动换行。
