Golang日志包使用与格式设置

在Golang实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《Golang log包使用与日志格式控制》，聊聊，希望可以帮助到正在努力赚钱的你。

Go语言log包默认输出到stderr，支持自定义前缀、标志位和输出目标。1. 使用log.SetFlags()设置日志格式，如Ldate、Ltime、Lshortfile等；2. 通过log.SetOutput()将日志写入文件；3. 利用log.New()创建带前缀和不同配置的独立日志实例；4. log包线程安全，适合并发环境使用。

Go语言的log包是标准库中用于记录日志的核心工具，使用简单且功能足够应对大多数基础场景。它默认将日志输出到标准错误（stderr），并支持自定义前缀、时间戳格式以及输出目标。下面介绍如何正确使用 log 包进行日志记录和格式控制。

设置日志前缀与标志位

通过log.SetFlags()可以控制日志输出时包含哪些信息，比如时间、文件名、行号等。常用标志如下：

• log.Ldate：输出日期，格式为 2006/01/02
• log.Ltime：输出时间，格式为 15:04:05
• log.Lmicroseconds：更精确的时间，包含微秒
• log.Llongfile：输出完整文件路径和行号
• log.Lshortfile：只输出文件名和行号
• log.LUTC：使用 UTC 时间而非本地时间
• log.Lmsgprefix：让前缀出现在消息前面（需配合 SetPrefix 使用）

示例代码：

log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)
log.Println("这是一条普通日志")
// 输出：2025/04/05 10:20:30 example.go:12: 这是一条普通日志

自定义日志输出位置

默认情况下，log 输出到 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)
}
log.SetOutput(file)
log.Println("这条日志会写入 app.log 文件中")

这样所有后续的日志都会自动写入指定文件，适合生产环境长期运行的服务。

创建不同用途的日志实例

对于复杂应用，可能需要多个独立的日志记录器，比如分别记录错误、调试或访问日志。可以使用log.New()创建自定义 logger 实例。

debugLog := log.New(os.Stdout, "DEBUG ", log.LstdFlags)
errorLog := log.New(os.Stderr, "ERROR ", log.Llongfile)

debugLog.Println("这是调试信息")
errorLog.Println("发生错误")

每个实例可拥有不同的输出目标、前缀和标志，便于分类管理和排查问题。

避免在高并发下出现竞态

log 包本身是线程安全的，所有写操作都有内部锁保护，因此可以直接在 goroutine 中调用Println、Printf等方法而无需额外同步。

但若自行封装日志逻辑或修改全局配置（如 SetOutput），应在程序初始化阶段完成，避免多个协程同时修改造成混乱。

基本上就这些。Go 的 log 包虽不如第三方库（如 zap、slog）强大，但对于多数项目已足够用。关键是合理设置输出格式与目标，并根据需要拆分日志流。不复杂但容易忽略细节。

今天关于《Golang日志包使用与格式设置》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于golang,日志的内容请关注golang学习网公众号！