Golang日志记录与格式化输出教程

Go语言标准库log提供基础日志功能，支持Print、Panic、Fatal三类输出，可通过SetFlags设置时间戳和文件信息，SetPrefix添加前缀，SetOutput重定向输出目标，适用于简单场景。

在Go语言开发中，日志记录是调试、监控和排查问题的重要手段。标准库 log 提供了基础的日志功能，使用简单且无需引入第三方依赖，适合中小型项目或学习阶段。

基本日志输出

Go 的 log 包默认提供 Print、Panic 和 Fatal 三类输出方式：

• log.Print / log.Println / log.Printf：常规信息输出，程序继续运行
• log.Panic：输出日志后触发 panic，中断执行
• log.Fatal：输出日志后调用 os.Exit(1)，立即终止程序

示例：

package main

import "log"

func main() {
    log.Print("普通日志")
    log.Println("换行日志")
    log.Printf("格式化日志: 用户 %s 登录", "Alice")

    // log.Fatal("致命错误") // 程序在此停止
}

添加时间戳与前缀

默认情况下，log 输出不包含时间信息。可通过 log.SetFlags 设置输出格式标志来启用时间戳、文件名、行号等。

常用标志包括：

• log.Ldate：日期（2006/01/02）
• log.Ltime：时间（15:04:05）
• log.Lmicroseconds：微秒级时间
• log.Llongfile：完整文件路径+行号
• log.Lshortfile：仅文件名+行号
• log.Lmsgprefix：使用设置的前缀

设置示例：

log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)
log.Println("带时间与行号的日志")
// 输出：2025/04/05 10:20:30 example.go:10: 带时间与行号的日志

自定义日志前缀

使用 log.SetPrefix 可为所有日志添加统一前缀，便于区分模块或环境。

例如：

log.SetPrefix("[用户服务] ")
log.SetFlags(log.LstdFlags | log.Lshortfile)
log.Println("用户登录成功")
// 输出：[用户服务] 2025/04/05 10:20:30 auth.go:8: 用户登录成功

输出到文件或其他目标

默认日志输出到标准错误（stderr），可通过 log.SetOutput 修改输出目标，比如写入文件。

示例：将日志写入文件

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.Println("这条日志会写入文件")

基本上就这些。标准库 log 虽然功能有限，但足够应对基础场景。若需要更高级功能如分级日志（debug/info/warn/error）、日志轮转、结构化输出，可考虑 zap、logrus 等第三方库。不过在多数简单服务中，原生 log 配合合理格式设置已能胜任。