feat(log): 改进日志分组功能，支持嵌套分组和分组名称显示

Author: kercylan98

log/example/main.go

@@ -7,30 +7,46 @@ import (
 )
 
 func main() {
-	var loggerA, loggerB log.Logger
+	// 创建基本的日志记录器
 	var builder = log.GetBuilder()
+	baseLogger := builder.Develop()
+
+	// 创建命名的日志记录器
+	userLogger := baseLogger.WithGroup("user")
+	authLogger := baseLogger.WithGroup("auth")
+	dbLogger := baseLogger.WithGroup("database")
+
+	// 使用命名的日志记录器
+	userLogger.Info("用户登录成功", "userId", "12345")
+	authLogger.Warn("检测到可疑的登录尝试", "ip", "192.168.1.100")
+	dbLogger.Error("数据库连接失败", log.Err(errors.New("connection timeout")))
+
+	// 演示嵌套命名
+	userAuthLogger := userLogger.WithGroup("auth")
+	userAuthLogger.Info("用户权限验证完成", "userId", "12345", "role", "admin")
+
+	// 演示与 WithGroup 结合使用
+	userGroupLogger := userLogger.WithGroup("session")
+	userGroupLogger.Info("会话已创建",
+		"sessionId", "abc123",
+		"duration", "30m",
+	)
 
-	loggerA = log.GetDefault()
-
-	loggerA = builder.Build()
-	loggerA = builder.Develop()
-	loggerA = builder.Test()
-	loggerA = builder.Production()
-	loggerA = builder.Silent()
-	loggerA = builder.DevelopOnGoland()
-
-	loggerB = builder.FromConfiguration(
+	// 演示完整的日志配置示例
+	configuredLogger := builder.FromConfiguration(
 		log.GetConfigBuilder().Build().
 			WithWriter(os.Stdout).
 			WithLeveler(log.LevelInfo),
 	)
 
-	loggerB = builder.FromConfigurators(log.LoggerConfiguratorFn(func(config log.LoggerConfiguration) {
-		config.WithEnableColor(true).WithLevelStr(log.LevelDebug, "debug")
-	}))
+	// 使用配置的日志记录器创建命名实例
+	apiLogger := configuredLogger.WithGroup("api")
+	apiLogger.Info("API服务启动成功", "port", 8080)
 
-	loggerC := builder.Multi(loggerA, loggerB)
-
-	loggerC.Error("Example", "err", errors.New("example error"))
-	loggerC.Error("Example", log.Err(errors.New("example error")))
+	// 演示多个日志记录器
+	multiLogger := builder.Multi(
+		apiLogger.WithGroup("service-a"),
+		apiLogger.WithGroup("service-b"),
+	)
+	multiLogger.Error("服务间通信失败", log.Err(errors.New("timeout")))
 }

log/handler.go

@@ -56,19 +56,20 @@ func (h *handler) Handle(ctx context.Context, record slog.Record) error {
 	h.formatTime(ctx, record, builder, options)
 	h.formatLevel(ctx, record, builder, options)
 	h.formatCaller(ctx, record, builder, options)
+	h.formatGroup(ctx, record, builder, options)
 	h.formatMessage(ctx, record, builder, options)
 
 	// fixed attrs
 	num := record.NumAttrs()
 	fixedNum := len(h.attrs)
 	for i, attr := range h.attrs {
-		h.formatAttr(ctx, h.group, record.Level, attr, builder, num+fixedNum == i+1, options)
+		h.formatAttr(ctx, record.Level, attr, builder, num+fixedNum == i+1, options)
 	}
 
 	idx := 0
 	record.Attrs(func(attr slog.Attr) bool {
 		idx++
-		h.formatAttr(ctx, h.group, record.Level, attr, builder, num == idx, options)
+		h.formatAttr(ctx, record.Level, attr, builder, num == idx, options)
 		return true
 	})
 
@@ -89,7 +90,11 @@ func (h *handler) WithAttrs(attrs []slog.Attr) slog.Handler {
 
 func (h *handler) WithGroup(name string) slog.Handler {
 	n := h.clone()
-	n.group = name
+	if h.group == "" {
+		n.group = name
+	} else {
+		n.group = fmt.Sprintf("%s.%s", h.group, name)
+	}
 	return n
 }
 
@@ -161,6 +166,18 @@ func (h *handler) formatCaller(ctx context.Context, record slog.Record, builder
 		Write(' ')
 }
 
+func (h *handler) formatGroup(ctx context.Context, record slog.Record, builder *colorbuilder.Builder, options LoggerOptionsFetcher) {
+	if h.group == "" {
+		return
+	}
+
+	h.loadAttrKeyWithOptions(builder, AttrKeyMessage, options)
+	h.loadColorWithOptions(builder, ColorTypeMessage, options).
+		WriteString(h.group).
+		DisableColor().
+		WriteString(" ")
+}
+
 func (h *handler) formatMessage(ctx context.Context, record slog.Record, builder *colorbuilder.Builder, options LoggerOptionsFetcher) {
 	if record.Message == "" {
 		return
@@ -177,17 +194,13 @@ func (h *handler) formatMessage(ctx context.Context, record slog.Record, builder
 		Write(' ')
 }
 
-func (h *handler) formatAttr(ctx context.Context, group string, level slog.Level, attr slog.Attr, builder *colorbuilder.Builder, last bool, options LoggerOptionsFetcher) {
-	var key = attr.Key
-	if group != "" {
-		key = group + "." + key
-	}
+func (h *handler) formatAttr(ctx context.Context, level slog.Level, attr slog.Attr, builder *colorbuilder.Builder, last bool, options LoggerOptionsFetcher) {
 
 	switch attr.Value.Kind() {
 	case slog.KindGroup:
 		groupAttr := attr.Value.Group()
 		for _, a := range groupAttr {
-			h.formatAttr(ctx, key, level, a, builder, last, options)
+			h.formatAttr(ctx, level, a, builder, last, options)
 		}
 		return
 	default:
@@ -209,18 +222,18 @@ func (h *handler) formatAttr(ctx context.Context, group string, level slog.Level
 					}
 				}
 				attr = slog.Group(attr.Key, slog.Any("info", stackError{v}), slog.Any("stack", stacks))
-				h.formatAttr(ctx, group, level, attr, builder, false, options)
+				h.formatAttr(ctx, level, attr, builder, false, options)
 				return
 			}
 			h.loadColorWithOptions(builder, ColorTypeAttrErrorKey, options)
 		}
 	}
 
 	builder.
-		WriteString(key).
+		WriteString(attr.Key).
 		SetColor(options.FetchColorType(ColorTypeAttrDelimiter)).
 		WriteString(options.FetchDelimiter())
-	h.formatAttrValue(ctx, level, key, attr, builder, last, options)
+	h.formatAttrValue(ctx, level, attr.Key, attr, builder, last, options)
 }
 
 func (h *handler) formatAttrValue(ctx context.Context, level slog.Level, fullKey string, attr slog.Attr, builder *colorbuilder.Builder, last bool, options LoggerOptionsFetcher) {