Golang如何使用log进行日志输出_Golang log日志管理实践

Go标准库log包提供基础日志功能,支持打印、格式化输出及程序退出控制;通过log.New可自定义前缀、标志位(如时间、文件名)和输出目标;虽无内置级别,但可封装实现debug、info、warn、error分级;支持输出到文件便于生产环境使用,适合多数简单场景。

Go语言标准库中的log包提供了简单高效的日志输出功能,适合中小型项目快速集成。虽然它不像第三方库(如zaplogrus)那样功能丰富,但在大多数场景下足以满足基础日志需求。

使用标准log包输出日志

导入log包后,可以直接调用其全局函数进行日志打印:

package main

import "log"

func main() { log.Println("这是一条普通日志") log.Printf("带变量的日志: 用户 %s 登录", "alice") log.Fatal("致命错误,程序将退出") log.Panic("触发panic,会先调用defer") }

说明:
- Println:输出信息,自动换行
- Printf:格式化输出
- Fatal:输出日志后调用os.Exit(1)
- Panic:输出日志后触发panic

自定义日志前缀和标志位

通过log.New()可以创建自定义Logger,控制输出格式和目标位置:

logger := log.New(os.Stdout, "[INFO] ", log.Ldate|log.Ltime|log.Lshortfile)
logger.Println("自定义日志格式")

常用标志位:
- log.Ldate:年月日
- log.Ltime:时分秒
- log.Lmicroseconds:微秒级时间
- log.Lshortfile:文件名和行号
- log.Llongfile:完整路径文件名和行号
- log.LUTC:使用UTC时间

多个标志可用按位或|组合。

多级别日志的实现思路

标准库不直接支持日志级别(如debug、info、warn),但可通过封装实现:

type Logger struct {
    debug *log.Logger
    info  *log.Logger
    warn  *log.Logger
    error *log.Logger
}

func NewLogger(prefix string) *Logger { return &Logger{ debug: log.New(os.Stdout, prefix+"[DEBUG] ", log.LstdFlags), info: log.New(os.Stdout, prefix+"[INFO] ", log.LstdFlags), warn: log.New(os.Stderr, prefix+"[WARN] ", log.LstdFlags), error: log.New(os.Stderr, prefix+"[ERROR] ", log.LstdFlags), } }

func (l *Logger) Debug(v ...interface{}) { l.debug.Println(v...) }

func (l *Logger) Info(v ...interface{}) { l.info.Println(v...) }

func (l *Logger) Warn(v ...interface{}) { l.warn.Println(v...) }

func (l *Logger) Error(v ...interface{}) { l.error.Println(v...) }

这样就能按级别区分日志输出,便于后期过滤和管理。

日志输出到文件

将日志写入文件是生产环境常见做法:

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()

logger := log.New(file, "", log.LstdFlags|log.Lshortfile) logger.Println("这条日志写入了文件")

注意:文件句柄应妥善关闭,建议配合defer使用。

基本上就这些。标准log包足够应对多数基础场景,结构清晰、开箱即用。若需更高性能或结构化日志,再考虑引入第三方库。合理设置前缀、标志和输出目标,能让日志更易读、易排查问题。