首页 > Golang > Go教程

Golang自定义日志输出教程

时间：2025-12-14 11:15:52 353浏览收藏

推广推荐

支持 PC / 移动端，安全直达

一分耕耘，一分收获！既然打开了这篇文章《Golang自定义日志输出实践》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

log.SetOutput用于设置Go日志输出目标，通过指定io.Writer接口实现日志写入文件、终端或多目标，结合SetFlags可定制格式，是构建灵活日志系统的基础。

Golang如何使用log.SetOutput自定义日志输出_Golang 日志输出自定义实践

在Go语言开发中，log.SetOutput 是一个非常实用的方法，用于自定义日志的输出目标。默认情况下，Go的 log 包将日志输出到标准错误（stderr），但在实际项目中，我们通常希望把日志写入文件、网络服务或同时输出到多个地方。通过 log.SetOutput(io.Writer)，我们可以灵活控制日志去向。

理解 log.SetOutput 的作用

log.SetOutput 是 Go 标准库 log 包提供的函数，用于设置全局日志输出目标。它的定义如下：

func SetOutput(w io.Writer)

参数 w 必须实现 io.Writer 接口，这意味着你可以传入文件、网络连接、缓冲区，甚至是自定义的写入器。

一旦调用 SetOutput，后续所有使用 log.Print、log.Printf、log.Println 的输出都会发送到指定的目标。

将日志输出到文件

最常见的需求是将日志写入本地文件。下面是一个简单示例：

package main

import (
  "log"
  "os"
)

func main() {
  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("这是一条测试日志")
}

这段代码会创建或追加写入 app.log 文件，并将日志内容写入其中。

同时输出到多个目标（如文件和终端）

有时我们既想保留日志文件，又希望在控制台看到输出。可以通过 io.MultiWriter 实现多路输出：

package main

import (
  "io"
  "log"
  "os"
)

func main() {
  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()

  multiWriter := io.MultiWriter(os.Stdout, file)
  log.SetOutput(multiWriter)

  log.Println("这条日志会同时出现在终端和文件中")
}

使用 io.MultiWriter 可以轻松组合多个输出流，适用于调试和生产环境兼顾的场景。

自定义日志格式与高级输出控制

虽然 log.SetOutput 控制输出位置，但日志前缀和时间格式由 log.SetFlags 控制。例如：

log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)

常用标志包括：

log.Ldate：输出日期
log.Ltime：输出时间
log.Lmicroseconds：更精确的时间
log.Lshortfile：输出文件名和行号
log.LUTC：使用UTC时间

结合 SetOutput 和 SetFlags，可以构建出满足项目需求的日志系统。

基本上就这些。log.SetOutput 虽然简单，但配合 io.Writer 接口的能力，提供了强大的扩展性。在小型项目中足够使用，大型项目可在此基础上封装或直接使用 zap、slog 等更高效的日志库。关键是理解输出目标的可替换性，这是实现日志解耦的基础。不复杂但容易忽略。

今天关于《Golang自定义日志输出教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！

golang 日志输出