开放内部实例

log.go

@@ -7,7 +7,7 @@ import (
 	"os"
 )
 
-var log *Logger
+var Log *Logger
 
 func init() {
 	consoleCfg := zap.NewDevelopmentEncoderConfig()
@@ -15,76 +15,76 @@ func init() {
 	jsonCfg := zap.NewProductionEncoderConfig()
 	jsonCfg.EncodeTime = zapcore.TimeEncoderOfLayout("2006-01-02 15:04:05")
 
-	log = &Logger{
+	Log = &Logger{
 		lv:           zap.NewAtomicLevelAt(zap.DebugLevel),
 		loggerConfig: &loggerConfig{SkipCaller: 2},
 	}
-	log.cores = append(log.cores,
-		zapcore.NewCore(zapcore.NewConsoleEncoder(consoleCfg), zapcore.AddSync(os.Stdout), log.lv),
+	Log.cores = append(Log.cores,
+		zapcore.NewCore(zapcore.NewConsoleEncoder(consoleCfg), zapcore.AddSync(os.Stdout), Log.lv),
 	)
-	log.flushLogger()
+	Log.flushLogger()
 }
 
 // With 见 Logger.With
 func With(k string, v any) *Logger {
-	return log.With(k, v)
+	return Log.With(k, v)
 }
 
 // Info 见 Logger.Info
 func Info(msg string, vs ...any) *Logger {
-	log.Info(msg, vs...)
-	return log
+	Log.Info(msg, vs...)
+	return Log
 }
 
 // Debug 见 Logger.Debug
 func Debug(msg string, vs ...any) *Logger {
-	log.Debug(msg, vs...)
-	return log
+	Log.Debug(msg, vs...)
+	return Log
 }
 
 // Warn 见 Logger.Warn
 func Warn(msg string, vs ...any) *Logger {
-	log.Warn(msg, vs...)
-	return log
+	Log.Warn(msg, vs...)
+	return Log
 }
 
 // Error 见 Logger.Error
 func Error(vs ...any) *Logger {
-	log.Error(vs...)
-	return log
+	Log.Error(vs...)
+	return Log
 }
 
 // Lv 见 Logger.Lv
 func Lv() Level {
-	return log.Lv()
+	return Log.Lv()
 }
 
 // SetLv 见 Logger.SetLv
 func SetLv(lv Level) *Logger {
-	log.SetLv(lv)
-	return log
+	Log.SetLv(lv)
+	return Log
 }
 
 // NewFileOutput 见 Logger.NewFileOutput
 func NewFileOutput(opts ...FileOutputOpt) *Logger {
-	log.NewFileOutput(opts...)
-	return log
+	Log.NewFileOutput(opts...)
+	return Log
 }
 
 // NewOutput 见 Logger.NewOutput
 func NewOutput(writer io.Writer) *Logger {
-	log.NewOutput(writer)
-	return log
+	Log.NewOutput(writer)
+	return Log
 }
 
 // SetLogger 替换fslog包默认的log对象
 // Logger 支持了zapcore级别的底层配置，见 Logger
 func SetLogger(logger *Logger) *Logger {
-	log = logger
-	return log
+	Log = logger
+	return Log
 }
 
 // Flush 见 Logger.Flush
 func Flush() {
-	log.Flush()
+	Log.Flush()
 }

logger.go

@@ -19,13 +19,13 @@ import (
 // 如非深度定制化扩展，非必要不建议使用 Logger.AddCore 进行扩展，该操作会
 // 导致客户端应用程序对zap包编译依赖，不保证fslog切换内部日志实现。
 type Logger struct {
+	// 日志打印用
+	Logger zap.SugaredLogger
+
 	// 互斥量
 	// 用于内部不可并发逻辑使用
 	lock sync.Mutex
 
-	// 日志打印用
-	logger zap.SugaredLogger
-
 	// 当前日志打印级别
 	// 借助zap内部级别设置机制，该机制
 	// 内部使用乐观锁，协程安全
@@ -58,7 +58,7 @@ func New(opts ...LoggerOption) *Logger {
 // 打印后，该信息会跟随日志一起打印
 func (l *Logger) With(k string, v any) *Logger {
 	newL := l.clone()
-	newL.logger = *newL.logger.With(zap.Any(k, v))
+	newL.Logger = *newL.Logger.With(zap.Any(k, v))
 	return newL
 }
 
@@ -66,30 +66,30 @@ func (l *Logger) With(k string, v any) *Logger {
 // 不同于zap内部可变参数逻辑，该可变参数是用于，字符串格式化的
 func (l *Logger) Debug(msg string, vs ...any) {
 	if len(vs) == 0 {
-		l.logger.Debug(msg)
+		l.Logger.Debug(msg)
 		return
 	}
-	l.logger.Debugf(msg, vs...)
+	l.Logger.Debugf(msg, vs...)
 }
 
 // Info 格式化打印信息级别日志
 // 不同于zap内部可变参数逻辑，该可变参数是用于，字符串格式化的
 func (l *Logger) Info(msg string, vs ...any) {
 	if len(vs) == 0 {
-		l.logger.Info(msg)
+		l.Logger.Info(msg)
 		return
 	}
-	l.logger.Infof(msg, vs...)
+	l.Logger.Infof(msg, vs...)
 }
 
 // Warn 格式化打印警告级别日志
 // 不同于zap内部可变参数逻辑，该可变参数是用于，字符串格式化的
 func (l *Logger) Warn(msg string, vs ...any) {
 	if len(vs) == 0 {
-		l.logger.Warn(msg)
+		l.Logger.Warn(msg)
 		return
 	}
-	l.logger.Warnf(msg, vs...)
+	l.Logger.Warnf(msg, vs...)
 }
 
 // Error 打印错误级别日志
@@ -105,11 +105,11 @@ func (l *Logger) Error(vs ...any) {
 	err, ok := vs[0].(error)
 	if ok {
 		if len(vs) == 1 {
-			l.logger.Errorf("%+v", err)
+			l.Logger.Errorf("%+v", err)
 			return
 		}
 
-		withed := l.logger.With(zap.String("err", fmt.Sprintf("%+v", err)))
+		withed := l.Logger.With(zap.String("err", fmt.Sprintf("%+v", err)))
 		msg, ok := vs[1].(string)
 		if ok {
 			withed.Errorf(msg, vs[2:])
@@ -123,12 +123,12 @@ func (l *Logger) Error(vs ...any) {
 	msg, ok := vs[0].(string)
 	if ok {
 		if len(vs) > 1 {
-			l.logger.Errorf(msg, vs[1:]...)
+			l.Logger.Errorf(msg, vs[1:]...)
 			return
 		}
 
 		if len(vs) == 1 {
-			l.logger.Error(vs[0])
+			l.Logger.Error(vs[0])
 			return
 		}
 	}
@@ -176,7 +176,7 @@ func (l *Logger) AddCore(core ...zapcore.Core) {
 
 // Flush 将缓冲区日志刷新至目标
 func (l *Logger) Flush() {
-	err := l.logger.Sync()
+	err := l.Logger.Sync()
 	if err != nil {
 		With("err", err.Error()).Warn("flushLogger log error")
 	}
@@ -200,7 +200,7 @@ func (l *Logger) clone() *Logger {
 func (l *Logger) flushLogger() {
 	l.lock.Lock()
 	defer l.lock.Unlock()
-	l.logger = *zap.
+	l.Logger = *zap.
 		New(
 			zapcore.NewTee(l.cores...),
 			zap.AddCaller(),