ansi颜色码不生效的根本原因是其依赖终端支持，而fmt不自动检测stdout是否为tty；windows旧版cmd默认禁用虚拟终端，重定向或ci环境会丢失颜色或输出乱码。
为什么直接用 fmt.Printf 打印 ANSI 颜色码有时不生效
常见现象是：本地终端能看到颜色，但重定向到文件、管道（如 go run main.go | grep error）或某些 CI 环境里颜色消失，甚至输出乱码。根本原因是 ANSI 转义序列依赖终端支持，而 Go 的 fmt 不自动检测 stdout 是否为 TTY。更麻烦的是，Windows 默认 cmd.exe 对 ANSI 支持有限（尤其旧版本），需要手动启用。
所以不能只拼接 "\033[31merror\033[0m" 了事——得先判断输出目标是否支持颜色，再决定是否渲染转义码。
- 用
isatty.IsTerminal(os.Stdout.Fd())（需引入github.com/mattn/go-isatty）判断是否连着真终端 - Windows 上建议加
color.NoColor = false并调用color.Init()（如果用github.com/fatih/color）或手动调用syscall.SetConsoleMode - CI 环境（如 GitHub Actions）通常设
FORCE_COLOR=1环境变量，应优先尊重它
用 github.com/fatih/color 包实现可配置的彩色日志包装函数
这个包封装了跨平台兼容逻辑，比手写 ANSI 更可靠。核心不是“怎么打印颜色”，而是“如何让日志函数自动适配环境”。它的 color.New().Printf 会自动跳过非终端输出，且支持禁用/强制启用。
一个典型包装函数长这样：
func LogError(v ...interface{}) {
if color.NoColor {
fmt.Fprintf(os.Stderr, "[ERROR] %v\n", v...)
return
}
color.Red("[ERROR]", v...).Println()
}
func LogInfo(v ...interface{}) {
if color.NoColor {
fmt.Printf("[INFO] %v\n", v...)
return
}
color.Blue("[INFO]", v...).Println()
}
- 必须在
init()或main()开头检查环境：color.NoColor = !isatty.IsTerminal(os.Stdout.Fd()) && os.Getenv("FORCE_COLOR") == "" - 避免在包装函数里反复调用
isatty——开销小但没必要，一次判断足矣 - 注意
color.Red(...).Println()和color.Red.Printf(...)行为不同：前者返回*color.Color对象，后者直接输出；混用容易漏换行
不用第三方包：手写 ANSI 包装函数要注意的三个细节
如果项目不允许引入外部依赖，可以自己封装，但必须处理好三件事：转义码兼容性、输出目标判断、Windows 特殊路径。
- ANSI 码要选通用的：
"\033[1;31m"（亮红）比"\033[31m"更易读，但别用\u001b替代\033——某些 Windows Go 版本解析不稳定 - Windows 10 1809+ 支持 ANSI，但需启用控制台虚拟终端序列：
syscall.SetConsoleMode(syscall.StdOut, 0x0007)（用golang.org/x/sys/windows） - 别把颜色逻辑和日志内容耦合太死——比如
Log("ERROR", "failed to open file")比LogError("failed to open file")更利于后续加前缀/时间戳
日志库集成时如何保留颜色而不破坏结构化输出
如果你用 log/slog 或 zap，直接在 Handler 里加 ANSI 码会导致 JSON 输出被污染。正确做法是：只在最终写入 os.Stdout 前做颜色包裹，且仅当 handler.Options.AddSource == false && handler.Options.Level == nil 这类非结构化场景启用。
-
slog.TextHandler可以 wrap 其Handle方法，在Record.Level.String()后插入对应颜色前缀 - 对
zap，自定义Encoder时检查enc.Core().CheckedEntry.Level，但必须绕过EncodeEntry的 JSON 分支 - 关键原则：颜色只作用于人类可读的终端输出层，绝不进入日志采集链路（如 Loki、ELK）
真正麻烦的不是怎么加颜色，而是怎么让颜色在不同输出目标间自动开关——多数人卡在没意识到 os.Stdout 和管道/文件句柄的行为差异上。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
