Go 夜读群讨论实录：println 与 fmt.Print 输出乱序之谜及 Go 终端彩色输出实战

Go 夜读群讨论实录：println 与 fmt.Print 输出乱序之谜及 Go 终端彩色输出实战

【免费下载链接】nightWeekly Go Online Meetup via Bilibili｜Go 夜读｜通过 bilibili 在线直播的方式分享 Go 相关的技术话题，每天大家在微信/telegram/Slack 上及时沟通交流编程技术话题。项目地址: https://gitcode.com/gh_mirrors/ni/night

本文是『Go 夜读』微信群 2019-03-07 技术讨论的深度整理与扩展，聚焦两个高频问题：一是println与fmt.Print混用时输出顺序为何不确定（涉及 stdout 与 stderr 两套输出流的本质）；二是如何基于 ANSI 转义序列在 Go 终端输出彩色文字、并封装一个带时间戳的分级彩色日志工具。读完本文，你将彻底理解 Go 内置println与标准库fmt.Println的底层差异，并掌握一套可直接复制到项目中的彩色日志封装方案。

1 乱序之谜：println 与 fmt.Print 谁先输出？

1.1 问题复现

在 Goland 中运行下面的代码，输出顺序竟然是"不确定"的：

package main import "fmt" func main() { println("hello") println("world") fmt.Print("go\n") }

同样的代码，在终端用go run运行，输出顺序却又总是确定的。这是为什么？

1.2 答案：它们写入了两个不同的输出流

关键在于：println输出到标准错误流 stderr，而fmt.Print/fmt.Println输出到标准输出流 stdout。

• Goland 等 IDE 会区分 stderr 与 stdout 两个通道（典型特征是 stderr 内容在 IDE 控制台中显示为红色），IDE 自行渲染这两个通道时，谁先被读取、被渲染并不保证与写入顺序一致，因此出现"乱序"。
• 而通过非 IDE（如 console）直接运行程序时，stderr 与 stdout 最终都汇聚到同一个终端文件描述符上，写入顺序得以保留，因此看起来"顺序确定"。

注意：这里的"顺序确定"仅指同一终端合并渲染的结果；从操作系统层面看，两条输出流是互相独立、彼此不同步的两个文件描述符，本质上不存在绝对的先后保证。

1.3 从源码看两个函数的本质区别

这一结论并非猜测，Go 官方文档与源码注释写得很清楚。在 content/discuss/2018-07-31-println-Println-and_context.md 中，『Go 夜读』群友已经扒过两个函数的源码注释：

• println内置函数：将其参数以实现相关（implementation-specific）的方式格式化，并写入标准错误流；用于引导（bootstrapping）和调试，且不保证在语言中永久保留。

// The println built-in function formats its arguments in an // implementation-specific way and writes the result to standard error. // Spaces are always added between arguments and a newline is appended. // Println is useful for bootstrapping and debugging; it is not guaranteed // to stay in the language. func println(args ...Type)

• fmt.Println：使用默认格式格式化操作数，并写入标准输出流，返回写入字节数与可能出现的错误。

// Println formats using the default formats for its operands and writes to standard output. // Spaces are always added between operands and a newline is appended. // It returns the number of bytes written and any write error encountered. func Println(a ...interface{}) (n int, err error) { return Fprintln(os.Stdout, a...) }

1.4 更深一层：为什么会有两个"不同步"的管道？

在类 Unix 系统中，标准输入、标准输出、标准错误分别对应编号为 0、1、2 的三个文件描述符/管道。不同管道的读写是并发的，彼此之间不存在互相等待，因此也就没有跨管道的"先后顺序"可言。

println走 fd=2（stderr），fmt.Println走 fd=1（stdout），两条输出并发写入各自的管道。如果你写一个足够大的循环反复输出，很容易观察到顺序确实是随机的——这与操作系统平台、Go 版本无关，是两套独立输出流的固有行为。

由此得到的工程启示：

1. 调试代码时优先使用fmt.Println/标准库log，它写向 stdout 且有明确、稳定的格式；
2. println写向 stderr，适合快速"打点"排查，但切勿依赖它与 stdout 输出的相对顺序；
3. 在 IDE 中观察输出时，stderr 往往被单独着色（如红色），看到"乱序"不要误以为是 Go 运行时或 IDE 的 bug。

2 Go 终端输出彩色文字方法

理解了输出流之后，另一个被群友反复追问的话题是：如何在 Go 终端输出带颜色的文字（比如彩色日志）？答案依赖 ANSI 转义序列（ANSI escape sequences），下面给出完整方案。

2.1 ANSI 转义序列：终端颜色控制原理

ANSI 转义序列是一种带内信号的转义序列标准，用于控制视频文本终端上的光标位置、颜色以及其他选项。在文本中嵌入确定的字节序列（大部分以 ESC 转义字符和[字符开始），终端会把这些字节序列解释为相应指令，而不是当作普通字符显示。

控制字符颜色的控制符一般由ESC[开始，中间包含若干个（包括 0 个）参数字节，最后以一个最终字节结束。例如：

\x1b[37;44;4;1m hello go \x1b[0m

表示hello go的格式为：蓝色背景（44）、灰色字体（37）、带下划线（4）且加粗（1）。对应的 Go 代码如下：

package main import "fmt" func main() { fmt.Printf("\x1b[37;44;4;1m hello go \x1b[0m") }

其中各部分的含义：

• \x1b：标志字符，代表转义序列开始，本质就是十六进制字节0x1B（也是 ESC 键的 ASCII 码）；
• [：转义序列的开始符；
• 以;分割的数字：控制参数（样式与颜色编码）；
• m：结束控制字符序列（SGR——Select Graphic Rendition 指令）。

2.2 常用文本样式控制符

1 位颜色编码

2.3 关于 ESC 的三种等价写法

ESC控制字符在源码中有多种等价表示，效果完全一致：

• \e：直接指代 Escape 字符；
• \x1b（或\x1B）：十六进制表示，即字节0x1B；
• \033：八进制表示（33 的八进制即 27，是 ESC 的 ASCII 码）。

在 content/discuss/2018-08-09-log-color-in-go.md 中，仓库还补充了一条简明的速查表：

\033[0m 重置为正常 \033[1m 设置高亮度或加粗 \033[4m 下划线 \033[5m 闪烁 \033[7m 反显 \033[8m 消隐 \033[30m -- \033[37m 设置前景色 \033[40m -- \033[47m 设置背景色

其中\x1b[即 CSI（Control Sequence Introducer，控制序列引导符）。例如：黑色前景\x1b[30m，红色前景\x1b[31m，红色加粗\x1b[31;1m，重置为缺省颜色\x1b[39;49m，重置所有属性\x1b[0m。

2.4 实战：基于 ANSI 编码的彩色日志封装

下面是在群讨论中沉淀下来的一个完整可运行的彩色日志示例。它用iota从 91 递增得到亮色前景编码，为不同日志级别绑定不同颜色，并自动拼接时间戳前缀：

package main import ( "fmt" "time" ) const ( color_red = uint8(iota + 91) color_green color_yellow color_blue color_magenta succ = "[succ]" error = "[error]" warn = "[warn]" info = "[info]" debug = "[debug]" ) func red(s string) string { return fmt.Sprint("\x1b[%dm%s\x1b[0m", color_red, s) } func green(s string) string { return fmt.Sprintf("\x1b[%dm%s\x1b[0m", color_green, s) } func yellow(s string) string { return fmt.Sprintf("\x1b[%dm%s\x1b[0m", color_yellow, s) } func blue(s string) string { return fmt.Sprintf("\x1b[%dm%s\x1b[0m", color_blue, s) } func magenta(s string) string { return fmt.Sprintf("\x1b[%dm%s\x1b[0m", color_magenta, s) } func Success(format string, a ...interface{}) { prefix := green(succ) fmt.Println(formatLog(prefix), fmt.Sprintf(format, a...)) } func Error(format string, a ...interface{}) { prefix := red(error) fmt.Println(formatLog(prefix), fmt.Sprintf(format, a...)) } func Warning(format string, a ...interface{}) { prefix := magenta(warn) fmt.Println(formatLog(prefix), fmt.Sprintf(format, a...)) } func Info(format string, a ...interface{}) { prefix := blue(info) fmt.Println(formatLog(prefix), fmt.Sprintf(format, a...)) } func Debug(format string, a ...interface{}) { prefix := yellow(debug) fmt.Println(formatLog(prefix), fmt.Sprintf(format, a...)) } func formatLog(prefix string) string { return time.Now().Format("2006/01/02 15:04:05") + "" + prefix + "" } func main() { Debug("%s", "hello, go") }

要点说明：

• color_red = uint8(iota + 91)借助iota依次得到 91、92、93、94、95，分别对应亮红、亮绿、亮黄、亮蓝、亮品红前景色，与上文的 1 位颜色编码表一一对应；
• 每个颜色函数返回\x1b[%dm...\x1b[0m包裹的字符串，\x1b[0m在末尾重置样式，避免颜色"泄漏"到后续日志；
• formatLog使用 Go 标准时间格式2006/01/02 15:04:05生成时间戳前缀，这是 Go 对"参考时间"约定俗成的写法；
• 日志函数采用可变参数format string, a ...interface{}签名，可像fmt.Printf一样传入格式化参数；
• 运行main中的Debug("%s", "hello, go")，即可在支持 ANSI 的终端看到黄色的[debug]前缀与时间戳。

2.5 仓库中的配套验证代码

该主题在『Go 夜读』仓库中并非孤例。早在 2018-08-09 的讨论中，就沉淀了一个可直接运行的测试文件 content/discuss/log_color_test.go，它用三层循环穷举所有前景色（30~37）、背景色（40~47）与样式组合（0/1/4/5/7/8），一次性打印出全部颜色效果：

for b := 40; b <= 47; b++ { for f := 30; f <= 37; f++ { for d := range []int{0, 1, 4, 5, 7, 8} { fmt.Printf(" %c[%d;%d;%dm%s(f=%d,b=%d,d=%d)%c[0m ", 0x1B, d, b, f, "", f, b, d, 0x1B) } fmt.Println("") } fmt.Println("") } fmt.Printf("%c[1;40;32m%s%c[0m", 0x1B, "testPrintColor", 0x1B) fmt.Println() fmt.Printf("%s\n", "testPrintColor")

其中%c[1;40;32m%s%c[0m中的参数分别为：1（高亮）、40（黑色背景）、32（绿色前景）、0（恢复默认颜色）。运行验证：

$ go test -v log_color_test.go

即可在终端看到完整色卡以及一行"高亮黑底绿字"的testPrintColor效果。

2.6 实战中的三点注意事项

1. 输出目标决定颜色是否生效：ANSI 颜色只在支持转义序列的终端（如 macOS Terminal、iTerm2、Linux 终端、VS Code 终端）中生效；重定向到文件或管道时，转义字节会原样写入（可能污染日志文件），工程化时建议提供--color开关或自动检测isatty。
2. 务必以\x1b[0m收尾：每次输出颜色后重置样式，否则后续所有输出都会被上一次的颜色"污染"。
3. stderr 与 stdout 的着色差异：结合第 1 节的结论，println（stderr）在 IDE 中显示为红色通道，若再叠加 ANSI 颜色，可能出现双重着色效果；生产代码建议统一走fmt/log输出流，把颜色仅当作终端渲染层的手段。

3 小结

本文围绕『Go 夜读』微信群的一次讨论，梳理了两个相互关联的终端输出话题：

• println与fmt.Print的乱序，源于它们分别写入 stderr 与 stdout 两条互不同步的输出流，IDE 对双通道的渲染放大了这一现象；其证据可直接在 Go 内置函数与 fmt.Println 的源码注释中找到。
• 彩色终端输出的底层是 ANSI 转义序列（ESC[+ 参数 +m），本文给出了完整的样式/颜色编码表、ESC 的三种等价写法、一个分级彩色日志封装示例，以及仓库中 log_color_test.go 提供的全量色卡验证方法。

相关的完整讨论还可在 2018-03-07 微信讨论 与 2018-08-09 Log 的颜色能设置吗 中继续查阅。

【免费下载链接】nightWeekly Go Online Meetup via Bilibili｜Go 夜读｜通过 bilibili 在线直播的方式分享 Go 相关的技术话题，每天大家在微信/telegram/Slack 上及时沟通交流编程技术话题。项目地址: https://gitcode.com/gh_mirrors/ni/night