掌握Go语言日志输出（log包编码格式详解与实战指南）

一、Go语言log包基础用法

Go 的 log 包默认会将日志输出到标准错误（stderr），并自动添加时间戳。最简单的使用方式如下：

package mainimport "log"func main() {    log.Println("这是一条普通日志")}

运行后输出类似：

2024/06/15 10:30:45 这是一条普通日志

二、控制日志的输出格式（Flags）

Go 的 log 包通过 SetFlags 函数来控制日志前缀信息的显示内容。这些标志（flags）决定了是否显示日期、时间、文件名、行号等。

常用 flags 包括：

• log.Ldate：显示日期（默认开启）
• log.Ltime：显示时间（默认开启）
• log.Lmicroseconds：微秒精度
• log.Llongfile：完整文件路径和行号
• log.Lshortfile：仅文件名和行号
• log.LUTC：使用 UTC 时间

示例：只显示时间+文件名+行号

package mainimport (    "log"    "os")func main() {    // 设置日志输出到标准输出（stdout）    log.SetOutput(os.Stdout)    // 设置日志格式：时间 + 短文件名和行号    log.SetFlags(log.Ltime | log.Lshortfile)    log.Println("Hello from Go log!")}

输出结果：

10:35:22 main.go:13: Hello from Go log!

三、自定义日志前缀（Prefix）

除了格式，你还可以为每条日志添加统一前缀，比如模块名或服务名：

log.SetPrefix("[API] ")log.Println("用户登录成功")

输出：

2024/06/15 10:40:00 [API] 用户登录成功

四、日志输出目标（Output Destination）

默认日志输出到 os.Stderr，但你可以通过 SetOutput 改为文件、网络连接或其他 io.Writer 接口实现。

package mainimport (    "log"    "os")func main() {    file, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)    if err != nil {        log.Fatal("无法创建日志文件:", err)    }    defer file.Close()    log.SetOutput(file)    log.SetFlags(log.LstdFlags | log.Lshortfile)    log.Println("这条日志将写入文件！")}

五、关于日志编码的说明

需要特别注意的是：Go 标准库的 log 包不直接处理字符编码（如 UTF-8、GBK）。它只是将字符串原样写入 io.Writer。因此，日志的“编码”实际上取决于你的输出目标（如终端、文件系统）所支持的编码。

在绝大多数现代系统（Linux/macOS/Windows 终端）中，默认使用 UTF-8 编码，所以中文等 Unicode 字符可以正常显示。如果你的日志出现乱码，请检查：

1. 终端或日志查看工具是否支持 UTF-8
2. 写入文件时是否以 UTF-8 模式打开（Go 默认就是 UTF-8）

因此，在 Go 语言日志输出 中，你无需额外设置编码，只要确保环境支持 UTF-8 即可。这也是为什么 Go语言新手教程 中很少强调编码问题的原因。

六、总结

通过本文，你已经掌握了 Go语言log包编码格式 的核心用法：

• 使用 SetFlags 控制时间、文件等前缀信息
• 使用 SetPrefix 添加自定义标签
• 使用 SetOutput 将日志写入文件或其他目标
• 理解日志编码依赖于系统环境，默认 UTF-8 安全可靠

这些技巧不仅能提升你的 Go日志设置 能力，还能让你在实际项目中更高效地排查问题。赶快动手试试吧！

关键词：Go语言日志输出, log包编码格式, Go日志设置, Go语言新手教程