用 text/tabwriter 可自动对齐中英文混排表格,需调用 flush();金额用 golang.org/x/text/message 格式化千分位;日期须显式 format;csv 导出应加 utf-8 bom 或用 encoding/csv 包。

Go 控制台输出表格对齐总歪?用 text/tabwriter 而不是拼空格
手动算中文字符宽度、用 fmt.Sprintf("%-12s", s) 对齐,基本都会翻车——中文占两个英文位,tabwriter 内部按 rune 列处理,自动适配中英文混排。它不渲染到终端,而是把内容先“写进缓冲区”,再统一格式化输出。
常见错误现象:fmt.Printf 直接打带中文的固定宽度字符串,表头和数据列错位;或用 \t 但终端没开 tab stop 导致缩进不一致。
- 必须调用
w.Flush(),否则什么也不输出 -
tabwriter.NewWriter(os.Stdout, 0, 0, 2, ' ', 0)第三个参数是 tab 宽度(建议 2),第四个是填充符(空格最稳) - 每行末尾要加
\n,不然所有内容挤在一行 - 别在写入前用
fmt.Println混用,会破坏 tabwriter 的行缓冲逻辑
tw := tabwriter.NewWriter(os.Stdout, 0, 0, 2, ' ', 0) fmt.Fprintln(tw, "日期\t类型\t金额\t备注") fmt.Fprintln(tw, "2024-05-20\t支出\t-28.50\t咖啡") fmt.Fprintln(tw, "2024-05-21\t收入\t+1500.00\t工资") tw.Flush()
金额数字右对齐、带千分位、保留两位小数?别自己写格式化逻辑
Go 标准库没有内置千分位支持,硬写 strconv.FormatFloat + 字符串切片容易漏负号、小数点、科学计数法等边界情况。直接用 golang.org/x/text/message 更可靠,它按 locale 做本地化格式,也支持强制指定 en-US 避免受系统影响。
使用场景:账本报表里金额列需要视觉上右对齐、数值清晰可扫读,尤其当有正负、小数、大额数字混排时。
立即学习“go语言免费学习笔记(深入)”;
- 导入包:
import "golang.org/x/text/message" - 初始化:
p := message.NewPrinter(message.MatchLanguage("en-US")) - 打印:
p.Printf("%.2f", 1234567.89)→1,234,567.89 - 注意:不能用在
tabwriter的fmt.Fprintln里直接传参,得先s := p.Sprintf("%.2f", v)再写入
日期列总是显示成 Go 默认时间戳格式?用 time.Format 显式控制
Go 的 time.Time 默认打印是 2006-01-02 15:04:05.999999999 -0700 MST,账本根本不需要秒和时区。不显式调用 .Format(),就等于放弃格式控制权。
容易踩的坑:time.Now().String() 或直接 fmt.Println(t) 输出,看着像 ISO 但其实带冗余信息;还有人误用 time.Parse 的 layout 去“转换”时间,结果 panic:parsing time xx: cannot parse xx as "2006-01-02"
- 标准日期格式字符串只有这一种:
"2006-01-02"(不是 "YYYY-MM-DD") - 想带时间?用
"2006-01-02 15:04",精确到分钟就够了 - 从字符串解析时间时,layout 必须和输入字符串完全匹配,比如
"2024/05/20"就得用"2006/01/02" - 别依赖
time.Local,用户换时区可能让报表日期突变,统一用time.UTC或存时区无关的日期(year/month/day三字段)
导出 CSV 时中文乱码、Excel 打不开?加 BOM 头不是万能解
Windows 上 Excel 默认用 GBK 解析无 BOM 的 UTF-8 CSV,所以你看到的是乱码。加 BOM 是兼容手段,但不是所有工具都认,且 BOM 本身会影响程序解析。更稳妥的做法是明确告知输出编码,并在文件名后缀体现意图。
性能影响很小,但兼容性差的后果很直接:用户双击打不开、列错位、日期变数字。
- 写文件前,用
[]byte("\xEF\xBB\xBF")开头写入(UTF-8 BOM) - 或者干脆输出
.csv.utf8后缀,提醒用户用记事本“另存为 UTF-8”再打开 - 避免用
fmt.Fprintln直接写 CSV,字段含逗号、换行、引号时必炸,改用encoding/csv包 -
csv.Writer不自动加 BOM,得自己w.Write([]byte("\xEF\xBB\xBF"))在w.WriteAll()前










