Go语言中使用标准log包可实现基本日志功能,通过log.Println或log.Printf输出带时间戳的日志,默认写入stderr;结合os.OpenFile可将日志写入文件,便于持久化;利用io.MultiWriter可同时输出到控制台和文件;通过log.New封装实现INFO、WARN、ERROR级别分类;适用于中小型项目,轻量且易维护,高级需求可选第三方库。

在Go语言开发中,日志是调试、监控和排查问题的重要工具。Golang标准库提供了log包用于基本的日志输出,结合文件写入、多输出目标和结构化日志思路,可以实现简单有效的日志收集与输出机制。
使用标准log包输出到控制台
最基本的日志输出可以直接使用log.Println或log.Printf,默认输出到标准错误(stderr)。
package main
import (
"log"
)
func main() {
log.Println("这是一条普通日志")
log.Printf("用户 %s 登录失败", "alice")
}
运行后会在终端打印时间戳和消息,格式如:2025/04/05 10:00:00 这是一条普通日志。
将日志写入文件
通过log.SetOutput()可以将日志重定向到文件,便于长期收集和分析。
立即学习“go语言免费学习笔记(深入)”;
示例:
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.Fatalf("无法打开日志文件: %v", err)
}
defer file.Close()
log.SetOutput(file)
log.Println("这条日志会写入文件")
log.Printf("处理用户请求: ID=%d", 1001)
}
每次调用log.Print系列函数时,内容都会追加到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.Fatalf("无法打开日志文件: %v", err)
}
defer file.Close()
// 多目标输出:文件 + 控制台
multiWriter := io.MultiWriter(os.Stdout, file)
log.SetOutput(multiWriter)
log.Println("这条日志同时出现在终端和文件中")
}
这种方式适合调试阶段,既能观察实时日志,又能留存记录。
添加日志级别(简易实现)
标准库不支持日志级别,但可以通过封装实现INFO、WARN、ERROR等分类。
package main
import (
"log"
"os"
)
var (
Info = log.New(os.Stdout, "INFO: ", log.Ldate|log.Ltime)
Warn = log.New(os.Stdout, "WARN: ", log.Ldate|log.Ltime)
Error = log.New(os.Stderr, "ERROR: ", log.Ldate|log.Ltime)
)
func main() {
Info.Println("应用启动")
Warn.Println("配置项缺失,使用默认值")
Error.Println("数据库连接失败")
}
输出示例:
INFO: 2025/04/05 10:05:00 应用启动WARN: 2025/04/05 10:05:00 配置项缺失,使用默认值ERROR: 2025/04/05 10:05:00 数据库连接失败
不同级别使用不同前缀,便于后期过滤和分析。
基本上就这些。标准库的log包足够应对大多数中小型项目的需求。若需更高级功能(如JSON格式、自动轮转、上下文追踪),可考虑集成zap、logrus等第三方库。但对轻量场景,原生方案简洁可控,易于维护。










