Go语言Zap日志库入门与实践从基础到高级用法在Go语言开发中日志是不可或缺的一部分。一个好的日志库能够帮助我们快速定位问题、监控系统状态。Uber开源的zap日志库以高性能、结构化和灵活性著称成为Go社区最受欢迎的日志库之一。本文将带你从零开始逐步掌握zap的核心功能并最终实现一个生产级的日志配置——包含时间格式化、颜色美化、双写、按时间/级别分片等。1. 为什么选择zap性能极佳zap采用零内存分配的设计性能远超标准库log和logrus。结构化日志支持强类型的字段便于日志检索和分析。灵活配置可自定义编码器、输出目标、日志级别等。两种API提供高性能的Logger和便捷的SugaredLogger满足不同场景。2. 安装使用Go模块安装bashgo get -u go.uber.org/zap3. 三种快速构建方法zap提供了三个开箱即用的构造函数方法特点zap.NewDevelopment()开发环境专用输出格式易读带颜色默认有行号级别为Debug。最常用zap.NewExample()示例用途无时间戳和行号输出JSON格式zap.NewProduction()生产环境推荐JSON格式带时间戳和行号级别为Info示例gologger, _ : zap.NewDevelopment() logger.Info(hello dev)4. 基本使用zap.Logger提供了Debug、Info、Warn、Error、Panic、Fatal等方法。gofuncmain(){logger,_:zap.NewDevelopment()logger.Debug(this is debug)logger.Info(this is info)logger.Warn(this is warn)logger.Error(this is error)logger.Panic(panic)// 会触发panic后续不执行logger.Fatal(fatal)// 会调用os.Exit(1)后续不执行}输出效果5. 设置日志级别通过配置可以调整日志级别只输出≥该级别的日志。gofuncmain(){cfg:zap.NewDevelopmentConfig()cfg.Levelzap.NewAtomicLevelAt(zap.ErrorLevel)// 只输出Error及以上logger,_:cfg.Build()logger.Debug(debug)// 不输出logger.Info(info)// 不输出logger.Warn(warn)// 不输出logger.Error(error)// 输出}实例结果级别大小关系Debug Info Warn Error DPanic Panic Fatal6. 时间格式化默认时间格式是RFC3339我们可以自定义为更易读的格式。gofuncmain(){cfg:zap.NewDevelopmentConfig()cfg.EncoderConfig.EncodeTimezapcore.TimeEncoderOfLayout(2006-01-02 15:04:05)logger,_:cfg.Build()logger.Info(自定义时间格式)}// 输出2026-07-10 15:04:05 INFO ... 自定义时间格式7. 标准日志 vs Sugar日志Logger强类型性能极致需使用zap.String、zap.Int等包装字段。SugaredLogger更灵活支持Infof格式化和Infow键值对性能依然优秀。两者可以轻松转换gologger,_:zap.NewDevelopment()// 标准用法logger.Info(hello,zap.String(name,tom),zap.Int(age,20))// Sugar用法sugar:logger.Sugar()sugar.Infof(hello %s,tom)sugar.Infow(hello,name,tom,age,20)8. 结构化日志添加字段可以在日志消息后面附加任意键值对方便后续查询。gologger.Info(this is a logger,zap.String(name,tom),zap.Int(age,8),zap.Bool(isAnimal,true),)输出JSON或console模式9. 输出美化颜色区分级别在开发环境中给不同级别加上颜色能提高可读性。我们可以自定义EncodeLevel。goconst(Blue\033[34mYellow\033[33mRed\033[31mPurple\033[35mReset\033[0m)funcencodeLevel(level zapcore.Level,enc zapcore.PrimitiveArrayEncoder){switchlevel{casezapcore.DebugLevel:enc.AppendString(BlueDEBUGReset)casezapcore.InfoLevel:enc.AppendString(YellowINFOReset)casezapcore.WarnLevel:enc.AppendString(PurpleWARNReset)casezapcore.ErrorLevel,zapcore.DPanicLevel,zapcore.PanicLevel,zapcore.FatalLevel:enc.AppendString(RedERRORReset)default:enc.AppendString(level.String())}}funcmain(){cfg:zap.NewDevelopmentConfig()cfg.EncoderConfig.EncodeLevelencodeLevel logger,_:cfg.Build()logger.Info(info in yellow)logger.Error(error in red)}10. 添加日志前缀自定义Encoder有时候我们希望每条日志都带上应用名称或服务标识可以通过包装Encoder实现。gotypemyEncoderstruct{zapcore.Encoder}func(m myEncoder)EncodeEntry(entry zapcore.Entry,fields[]zapcore.Field)(*buffer.Buffer,error){buff,err:m.Encoder.EncodeEntry(entry,fields)iferr!nil{returnbuff,err}data:buff.String()buff.Reset()buff.AppendString([myApp] data)// 添加前缀returnbuff,nil}funcmain(){core:zapcore.NewCore(myEncoder{Encoder:zapcore.NewConsoleEncoder(zap.NewDevelopmentEncoderConfig())},os.Stdout,zapcore.InfoLevel,)logger:zap.New(core,zap.AddCaller())logger.Info(with prefix)}// 输出[myApp] 2026-07-10T... INFO ... with prefix11. 日志双写控制台 文件两种常见方式方式一使用zapcore.NewTee组合多个coregofuncmain(){cfg:zap.NewDevelopmentConfig()cfg.EncoderConfig.EncodeTimezapcore.TimeEncoderOfLayout(2006-01-02 15:04:05)consoleCore:zapcore.NewCore(zapcore.NewConsoleEncoder(cfg.EncoderConfig),os.Stdout,zapcore.DebugLevel,)file,_:os.OpenFile(app.log,os.O_CREATE|os.O_APPEND|os.O_WRONLY,0666)fileCore:zapcore.NewCore(zapcore.NewConsoleEncoder(cfg.EncoderConfig),file,zapcore.DebugLevel,)teeCore:zapcore.NewTee(consoleCore,fileCore)logger:zap.New(teeCore,zap.AddCaller())logger.Info(both console and file)}方式二使用zapcore.NewMultiWriteSyncergofuncmain(){cfg:zap.NewDevelopmentConfig()cfg.EncoderConfig.EncodeTimezapcore.TimeEncoderOfLayout(2006-01-02 15:04:05)file,_:os.OpenFile(app.log,os.O_CREATE|os.O_APPEND|os.O_WRONLY,0666)ws:zapcore.NewMultiWriteSyncer(os.Stdout,file)core:zapcore.NewCore(zapcore.NewConsoleEncoder(cfg.EncoderConfig),ws,zapcore.DebugLevel,)logger:zap.New(core,zap.AddCaller())logger.Info(dual output)}12. 日志分片按时间实际生产环境需要按天或按小时切割日志文件。我们可以自定义WriteSyncer在写入时检查日期若变化则新建文件。gotypemyWriterstruct{file*os.File mutex sync.Mutex currentDatestring}func(w*myWriter)Write(p[]byte)(nint,errerror){w.mutex.Lock()deferw.mutex.Unlock()now:time.Now().Format(2006-01-02)ifw.currentDate!now{ifw.file!nil{w.file.Close()}name:fmt.Sprintf(logs/%s.log,now)os.MkdirAll(logs,0755)file,err:os.OpenFile(name,os.O_CREATE|os.O_APPEND|os.O_WRONLY,0666)iferr!nil{return0,err}w.filefile w.currentDatenow}returnw.file.Write(p)}funcmain(){cfg:zap.NewDevelopmentConfig()cfg.EncoderConfig.EncodeTimezapcore.TimeEncoderOfLayout(2006-01-02 15:04:05)ws:zapcore.NewMultiWriteSyncer(os.Stdout,zapcore.AddSync(myWriter{}))core:zapcore.NewCore(zapcore.NewConsoleEncoder(cfg.EncoderConfig),ws,zapcore.DebugLevel,)logger:zap.New(core,zap.AddCaller())fori:0;i10;i{logger.Sugar().Infof(log %d,i)time.Sleep(time.Second)// 模拟跨天}}13. 按日志级别分片例如将Error级别的日志单独写入err.log。gotypelevelEncoderstruct{zapcore.Encoder errFile*os.File}func(e levelEncoder)EncodeEntry(entry zapcore.Entry,fields[]zapcore.Field)(*buffer.Buffer,error){buf,err:e.Encoder.EncodeEntry(entry,fields)iferr!nil{returnbuf,err}ifentry.Levelzapcore.ErrorLevel{ife.errFilenil{e.errFile,_os.OpenFile(err.log,os.O_CREATE|os.O_APPEND|os.O_WRONLY,0666)}e.errFile.WriteString(buf.String())}returnbuf,nil}funcmain(){core:zapcore.NewCore(levelEncoder{Encoder:zapcore.NewConsoleEncoder(zap.NewDevelopmentEncoderConfig())},os.Stdout,zapcore.InfoLevel,)logger:zap.New(core,zap.AddCaller())logger.Info(info)logger.Error(error)// 会额外写入 err.log}14. 综合应用生产级日志封装将上述所有功能整合时间格式化、颜色美化、预设前缀、双写控制台文件、按时间分片、错误日志单独分片并使用全局日志。gopackagemainimport(fmtossynctimego.uber.org/zapgo.uber.org/zap/buffergo.uber.org/zap/zapcore)// 自定义 Encoder实现前缀、按时间分片、错误单独分片typelogEncoderstruct{zapcore.Encoder errFile*os.File outFile*os.File currentDatestringmu sync.Mutex}const(Blue\033[0;34mYellow\033[0;33mRed\033[0;31mReset\033[0m)func(e*logEncoder)EncodeEntry(entry zapcore.Entry,fields[]zapcore.Field)(*buffer.Buffer,error){// 调用原始编码buf,err:e.Encoder.EncodeEntry(entry,fields)iferr!nil{returnbuf,err}// 添加前缀data:buf.String()buf.Reset()buf.AppendString([MyApp] data)databuf.String()e.mu.Lock()defere.mu.Unlock()now:time.Now().Format(2006-01-02)ife.currentDate!now{// 创建日期目录dir:fmt.Sprintf(logs/%s,now)os.MkdirAll(dir,0755)// 常规日志文件outName:fmt.Sprintf(%s/out.log,dir)outFile,_:os.OpenFile(outName,os.O_CREATE|os.O_APPEND|os.O_WRONLY,0666)e.outFileoutFile// 错误日志文件单独errName:fmt.Sprintf(%s/err.log,dir)errFile,_:os.OpenFile(errName,os.O_CREATE|os.O_APPEND|os.O_WRONLY,0666)e.errFileerrFile e.currentDatenow}// 写入常规文件ife.outFile!nil{e.outFile.WriteString(data)}// 如果是 Error 级别额外写入 errFileifentry.Levelzapcore.ErrorLevele.errFile!nil{e.errFile.WriteString(data)}returnbuf,nil}// 自定义级别颜色funcencodeLevel(level zapcore.Level,enc zapcore.PrimitiveArrayEncoder){switchlevel{casezapcore.InfoLevel:enc.AppendString(BlueINFOReset)casezapcore.WarnLevel:enc.AppendString(YellowWARNReset)casezapcore.ErrorLevel,zapcore.DPanicLevel,zapcore.PanicLevel,zapcore.FatalLevel:enc.AppendString(RedERRORReset)default:enc.AppendString(level.String())}}// 初始化全局 loggerfuncInitLogger()*zap.Logger{cfg:zap.NewDevelopmentConfig()cfg.EncoderConfig.EncodeTimezapcore.TimeEncoderOfLayout(2006-01-02 15:04:05)cfg.EncoderConfig.EncodeLevelencodeLevel encoder:logEncoder{Encoder:zapcore.NewConsoleEncoder(cfg.EncoderConfig),}core:zapcore.NewCore(encoder,os.Stdout,// 同时输出到控制台由WriteSyncer决定这里我们只把控制台作为输出但我们在Encoder里已经写了文件所以控制台也输出zapcore.InfoLevel,)logger:zap.New(core,zap.AddCaller())zap.ReplaceGlobals(logger)// 替换全局 loggerreturnlogger}funcmain(){InitLogger()// 使用全局 loggerzap.L().Info(this is info)zap.L().Warn(this is warn)zap.L().Error(this is error)// 也可以使用 Sugaredzap.S().Infof(sugar %s,example)}这个封装已经可以满足多数生产需求每天自动创建文件夹out.log记录所有日志err.log单独记录错误控制台输出彩色同时带有前缀和时间格式化。15. 总结通过本文的学习你已经掌握了zap日志库的常用功能快速上手Development/Production日志级别控制时间格式化结构化日志颜色美化自定义前缀双写控制台文件按时间、按级别分片封装全局日志Zap的灵活性极高你可以基于这些基础实现更复杂的定制例如输出JSON格式、接入ELK、动态调整级别等。希望本文能帮助你在项目中更好地使用zap让日志成为你排查问题的得力助手。参考资料Zap GitHubZap 官方文档