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

Go语言标准库中的log包提供了简单高效的日志输出功能,适合中小型项目快速集成。虽然它不像第三方库(如zap或logrus)那样功能丰富,但在大多数场景下足以满足基础日志需求。
使用标准log包输出日志
导入log包后,可以直接调用其全局函数进行日志打印:
package mainimport "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,控制输出格式和目标位置:
立即学习“go语言免费学习笔记(深入)”;
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包足够应对多数基础场景,结构清晰、开箱即用。若需更高性能或结构化日志,再考虑引入第三方库。合理设置前缀、标志和输出目标,能让日志更易读、易排查问题。










