golang 日志log与logrus示例详解

 更新时间:2025年03月31日 12:00:56   作者:草海桐  
log是Go语言标准库中一个简单的日志库,本文给大家介绍golang 日志log与logrus示例详解,感兴趣的朋友一起看看吧

一、Go 标准库 log 详解

1. 功能特点

log 是 Go 语言标准库中一个简单的日志库,主要功能包括:

  • 写入日志到指定位置(默认为标准错误)
  • 支持_FATAL 和 _ERROR 等级别的日志
  • 支持格式化日志输出

2. 常用函数

log 包中常用的函数如下:

函数名功能
log.Print输出日志
log.Printf格式化输出日志
log.Println输出日志,自动换行
log.Fatal输出日志并调用 os.Exit(1)
log.Fatalf格式化输出日志并退出
log.Panic输出日志并引发 panic
log.Panicln格式化输出日志并引发 panic
log.SetFlags设置日志格式(日期、时间等)
log.SetOutput设置日志输出目标

3. 示例代码

package main  
import (  
    "log"  
    "os"  
)  
func main() {  
    // 1. 默认输出到标准错误  
    log.Println("这是一条普通日志")  
    // 2. 格式化输出  
    name := "Alice"  
    age := 30  
    log.Printf("用户 %s 已经 %d 岁了\n", name, age)  
    // 3. 设置日志输出目标为文件  
    file, err := os.OpenFile("log.txt", os.O_WRONLY|os.O_CREATE|os.O_APPEND, 0644)  
    if err != nil {  
        log.Fatal(err)  
    }  
    log.SetOutput(file)  
    log.Println("日志已切换到文件输出")  
    // 4. 设置日志格式(默认包含时间信息)  
    log.SetFlags(log.LstdFlags)  
    //Ldate         = 1 << iota     // 使用本地时区的日期:2009/01/23
	//Ltime                         // 使用本地时区的时间:01:23:23
	//Lmicroseconds                 // 微秒精度的时间:01:23:23.123123。假设启用了Ltime
	//Llongfile                     // 完整文件名和行号:/a/b/c/d.go:23
	//Lshortfile                    // 文件名的最后一部分和行号:d.go:23。覆盖Llongfile
	//LUTC                          // 如果设置了Ldate或Ltime,则使用UTC而不是本地时区
	//Lmsgprefix                    // 将“前缀”从行首移动到消息之前
	//LstdFlags     = Ldate | Ltime // 标准logger的初始值,包含日期和时间
    log.Println("这是一条包含时间的日志")  
    log.Panic("Panic\n")
	//log.Fatal("Fatal\n")
}  

4. 优势和局限

优势

  • 内置库,使用简单,不需要额外依赖。
  • 支持基本的日志输出和格式化。

局限

  • 功能较简单,不支持多日志级别(如 DEBUG、INFO、WARNING 等)。
  • 不支持 JSON 格式化输出。
  • 不支持日志轮转(logrotate)。

二、第三方库 logrus 详解

1. 功能特点

logrus 是 Go 语言中一个功能强大的日志库,主要特点如下:

  • 支持多种日志级别:DebugInfoWarningErrorFatalPanic
  • 支持两种输出格式:text 和 json
  • 支持日志轮转(结合 lumberjack 包)
  • 支持钩子(Hooks)机制,扩展日志处理逻辑
  • 支持多种输出目标(文件、网络、console 等)

2. 核心功能

以下是 logrus 的核心功能:

          1 .多日志级别

logger.Debug("调试日志")  
logger.Info("信息日志")  
logger.Warn("警告日志")  
logger.Error("错误日志")  
logger.Fatal("致命错误")  
logger.Panic("panic 日志")  

        2. 格式化输出

logger.WithFields(logrus.Fields{  
    "username": "Alice",  
    "age":       30,  
}).Info("用户信息")  

        3. 切换输出格式

// 切换到 JSON 格式  
logger.SetFormatter(&logrus.JSONFormatter{})  
// 配置日志格式为 text(默认)
//logger.SetFormatter(&logrus.TextFormatter{})

        4.设置日志输出目标

logger.SetOutput(os.Stdout) // 输出到标准输出  

        5. 日志轮转(结合 lumberjack)

// 须import(
    lumberjack "gopkg.in/natefinch/lumberjack.v2"
)
writer := &lumberjack.Logger{  
    Filename:   "logs/app.log",  
    MaxSize:     500, // MB  
    MaxBackups:  3,  
    MaxAge:      28, // days  
    Compress:   true,  
}  
logger.SetOutput(writer)  

3. 示例代码

以下是一个完整的 logrus 示例代码,包含日志级别、格式化、文件轮转和钩子功能:

package main  
import (  
    "log"  
    "os"  
    "os/signal"  
    "syscall"  
    "time"  
    lumberjack "gopkg.in/natefinch/lumberjack.v2" 
    "github.com/sirupsen/logrus"  
)  
func main() {  
    // 1. 创建 logger 实例  
    logger := logrus.New()  
    // 2. 配置日志级别  
    logger.SetLevel(logrus.InfoLevel)  
    // 3. 配置日志格式为 JSON  
    logger.SetFormatter(&logrus.JSONFormatter{})  
    // 4. 配置日志轮转  
    writer := &lumberjack.Logger{  
        Filename:   "logs/app.log",  
        MaxSize:     500, // MB  
        MaxBackups:  3,  
        MaxAge:      28, // days  
        Compress:   true,  
    }  
    logger.SetOutput(writer)  
    // 5. 添加钩子(Hook)  
    logger.AddHook(&MyHook{})  
    // 6. 写入日志  
    logger.Info("这是一个 Info 级别的日志")  
    // 7. 带字段的日志  
    logger.WithFields(logrus.Fields{  
        "username": "Bob",  
        "age":      25,  
    }).Error("用户未找到")  
    // 8. 处理信号  
    signalChan := make(chan os.Signal, 1)  
    signal.Notify(signalChan, syscall.SIGINT, syscall.SIGTERM)  
    go func() {  
        <-signalChan  
        logger.Info("程序已优雅退出")  
        os.Exit(0)  
    }()  
}  
// 自定义钩子示例  
type MyHook struct{}  
func (*MyHook) Levels() []logrus.Level {  
    return []logrus.Level{  
        logrus.InfoLevel,  
        logrus.ErrorLevel,  
    }  
}  
func (*MyHook) Fire(entry *logrus.Entry) error {  
    // 钩子逻辑:例如发送日志到远程服务器  
    log.Printf("钩子处理:%+v\n", entry)  
    return nil  
}  

4. 优势和扩展性

  • 优势
    • 功能强大,支持多日志级别和格式化。
    • 高度可定制,支持钩子机制和多种输出目标。
    • 社区生态丰富,广泛应用于生产环境。
  • 扩展性
    • 支持第三方库扩展(如日志轮转、网络输出等)。

三、总结

1. 何时选择 log

  • 当项目的日志需求简单(只需要基本的日志输出)。
  • 项目不希望引入额外的依赖。

2. 何时选择 logrus

  • 项目需要多日志级别和格式化输出。
  • 需要更高的可定制性和扩展性。
  • 需要支持日志轮转和钩子机制。

3. 对比总结

特性loglogrus
日志级别有限(Fatal、Error)多级别(Debug~Panic)
格式化输出支持支持(Text/JSON)
日志轮转不支持支持(需配合 lumberjack)
钩子机制不支持支持
输出目标标准输出/文件多种(文件、网络等)
社区和扩展性内置库第三方库,社区丰富

到此这篇关于golang 日志log与logrus的文章就介绍到这了,更多相关golang 日志log与logrus内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Golang map与sync.map的异同详解

    Golang map与sync.map的异同详解

    在Go语言中,map和sync.Map都是用于存储键值对的数据结构,但它们在并发安全性、性能和使用场景上存在显著差异,接下来将深入探讨这两种数据结构的异同,感兴趣的朋友可以参考下
    2024-01-01
  • Go语言基于Goroutine的超时控制方案设计与实践

    Go语言基于Goroutine的超时控制方案设计与实践

    Go语言因其并发特性而备受青睐,尤其是goroutine和channel的组合,像一对默契的搭档,为开发者提供了轻量、高效的并发工具,下面我们来看看基于goroutine的超时控制方案吧
    2025-05-05
  • 使用Go语言提高图片分辨率的方法与实践

    使用Go语言提高图片分辨率的方法与实践

    在图像处理和计算机视觉领域,提高图片分辨率是一个常见的问题,随着高分辨率显示设备的普及,如4K、8K电视以及高像素手机摄像头的应用,用户对高质量图片的需求也越来越高,本文将介绍使用Golang语言提高图片分辨率的方法与实践,需要的朋友可以参考下
    2023-12-12
  • Golang JSON的进阶用法实例讲解

    Golang JSON的进阶用法实例讲解

    这篇文章主要给大家介绍了关于Golang JSON进阶用法的相关资料,文中通过示例代码介绍的非常详细,对大家学习或者使用golang具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2018-09-09
  • Go 第三方库之类型转换问题

    Go 第三方库之类型转换问题

    今天给大家介绍一个第三方库,专门处理类型转换的问题。对Go 第三方库之类型转换问题感兴趣的朋友跟随小编一起看看吧
    2021-08-08
  • golang如何判断字符串是否包含中文

    golang如何判断字符串是否包含中文

    这篇文章主要介绍了golang如何判断字符串是否包含中文问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-07-07
  • Golang控制协程执行顺序方法详解

    Golang控制协程执行顺序方法详解

    这篇文章主要介绍了Golang控制协程执行顺序的方法,Golang的语法和运行时直接内置了对并发的支持。Golang里的并发指的是能让某个函数独立于其他函数运行的能力
    2022-11-11
  • GoLang中Module的基本使用方法

    GoLang中Module的基本使用方法

    Go module是从Go 1.11版本才引入的新功能,下面这篇文章主要给大家介绍了关于GoLang中Module的基本使用方法,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2023-01-01
  • Go 日志封装实战示例详解

    Go 日志封装实战示例详解

    这篇文章主要为大家介绍了Go 日志封装实战示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-04-04
  • Go string转int,int64,int32及注意事项说明

    Go string转int,int64,int32及注意事项说明

    这篇文章主要介绍了Go string转int,int64,int32及注意事项说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-07-07

最新评论