Golang自定义log.Logger格式设置方法

在Golang中，标准库`log.Logger`提供了基础的日志功能，但默认格式可能无法满足所有需求。本文详细介绍了如何利用`log.New`函数，通过配置不同的标志位（flags），例如`log.Ldate`、`log.Ltime`、`log.Lshortfile`等，来自定义日志输出的时间、日期、文件名和行号等信息，从而创建结构化的日志格式。此外，文章还探讨了如何结合`io.Writer`实现日志的多目标输出，例如同时输出到控制台和文件。虽然标准库不支持完全自由的格式，但可以通过封装函数的方式，实现更灵活的日志格式，或者选择使用第三方日志库如`zap`或`logrus`来满足更复杂的需求。对于轻量级项目，掌握`log.New`的用法足以实现清晰实用的自定义日志格式。

答案：通过log.New配置标志位可自定义日志格式，结合io.Writer实现多目标输出，封装函数可扩展格式灵活性。

在Golang中，log.Logger 是标准库提供的日志工具，虽然默认输出格式较为简单，但支持自定义格式。通过合理配置，可以输出包含时间、文件名、行号等信息的结构化日志。

1. 使用 log.New 自定义前缀和标志

log.Logger 的核心是 log.New() 函数，它接收三个参数：输出目标、前缀和标志位（flags）。标志位控制日志头信息的显示内容。

常见标志包括：

• log.Ldate - 输出日期（2025/04/05）
• log.Ltime - 输出时间（14:30:45）
• log.Lmicroseconds - 更精确的时间
• log.Llongfile - 显示完整文件路径和行号
• log.Lshortfile - 只显示文件名和行号
• log.LUTC - 使用UTC时间
• log.Lmsgprefix - 前缀放在消息前面（Go 1.16+）

示例：

logger := log.New(os.Stdout, "[INFO] ", log.Ldate|log.Ltime|log.Lshortfile)
logger.Println("这是一条自定义日志")
// 输出：[INFO] 2025/04/05 14:30:45 main.go:10: 这是一条自定义日志

2. 实现更灵活的日志格式

标准库不支持完全自由的格式（如 JSON），但可以通过封装函数实现类似效果。

例如，创建一个带级别和时间戳的格式：

func LogInfo(msg string) {
    now := time.Now().Format("2006-01-02 15:04:05")
    _, file, line, _ := runtime.Caller(1)
    filename := filepath.Base(file)
    fmt.Printf("[%s] [INFO] %s:%d - %s\n", now, filename, line, msg)
}

调用 LogInfo("用户登录") 会输出：

[2025-04-05 14:30:45] [INFO] main.go:15 - 用户登录

3. 结合 io.Writer 实现多目标输出

log.Logger 支持将日志同时写入多个地方，比如控制台和文件。

file, _ := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
multiWriter := io.MultiWriter(os.Stdout, file)
logger := log.New(multiWriter, "", log.LstdFlags|log.Lshortfile)
logger.Println("这条日志会同时打印到屏幕和文件")

基本上就这些。标准库的 log.Logger 能满足大多数基础需求，若需 JSON 格式或更复杂的日志管理，建议使用第三方库如 zap 或 logrus。但对于轻量级项目，合理使用 log.New 和标志位就能实现清晰实用的自定义日志格式。

以上就是《Golang自定义log.Logger格式设置方法》的详细内容，更多关于的资料请关注golang学习网公众号！