在goframe框架中,可以通过实现 log.handler 接口来自定义控制台日志的色彩与输出格式。具体做法是编写一个结构体实现 handle(ctx context.context, entry *log.entry) 方法,在其中解析日志内容并根据级别(如 error、warn)使用 ansi 转义码设置颜色,最后调用底层 handler 或自行写入 os.stdout。

如何注册自定义的日志处理器
要实现自定义色彩,需要实例化自定义的 Handler 并将其注册到全局日志管理器 glog 中。通过 glog.SetHandler() 替换默认的 Handler,即可让所有后续日志输出都经过自定义逻辑处理。

package main
import (
"context"
"fmt"
"os"
"github.com/gogf/gf/v2/log"
"github.com/gogf/gf/v2/os/glog"
)
// CustomHandler 实现了 log.Handler 接口
type CustomHandler struct {
// 可以嵌入默认 handler 或者完全自定义
}
func (h *CustomHandler) Handle(ctx context.Context, entry *log.Entry) {
// 获取日志级别
level := entry.Level
color := "\033[0m" // 默认白色
switch level {
case glog.LevelError:
color = "\033[31m" // 红色
case glog.LevelWarn:
color = "\033[33m" // 黄色
case glog.LevelInfo:
color = "\033[32m" // 绿色
default:
color = "\033[0m"
}
// 格式化输出:时间 + 级别 + 消息
output := fmt.Sprintf("%s[%s] %s%s\033[0m\n",
color,
level.String(),
entry.Message,
color,
)
os.Stdout.WriteString(output)
}
func main() {
// 注册自定义 Handler
glog.SetHandler(&CustomHandler{})
// 测试输出
glog.Info("这是一条普通信息")
glog.Warn("这是一条警告信息")
glog.Error("这是一条错误信息")
}
运行上述代码后,控制台将显示带有颜色的日志。Info 为绿色,Warn 为黄色,Error 为红色。这种实现方式完全接管了日志输出,适合对格式有严格要求的场景。
如何在保留原有功能基础上增强色彩
如果希望保留 GoFrame 原有的日志轮转、文件输出等功能,仅增加控制台色彩,可以创建一个装饰器模式的 Handler。它内部持有原始的 Handler,在 Handle 方法中先判断是否为控制台输出,如果是则添加颜色,否则直接委托给原始 Handler。

package main
import (
"context"
"fmt"
"os"
"github.com/gogf/gf/v2/log"
"github.com/gogf/gf/v2/os/glog"
)
// ColorDecorator 装饰器模式,增强原有 Handler
type ColorDecorator struct {
original log.Handler
}
func NewColorDecorator(original log.Handler) *ColorDecorator {
return &ColorDecorator{original: original}
}
func (d *ColorDecorator) Handle(ctx context.Context, entry *log.Entry) {
// 检查是否配置了控制台输出
if d.original != nil && d.original.IsConsoleOutput() {
// 应用颜色逻辑
color := "\033[0m"
switch entry.Level {
case glog.LevelError:
color = "\033[31m"
case glog.LevelWarn:
color = "\033[33m"
case glog.LevelInfo:
color = "\033[32m"
}
// 这里可以修改 entry.Message 或者单独打印
// 为了简单演示,我们直接打印带颜色的版本到 stdout
// 注意:这可能会造成重复输出,实际项目中需仔细设计
fmt.Printf("%s%s\033[0m\n", color, entry.Message)
}
// 委托给原始 Handler 处理其他逻辑(如写文件)
if d.original != nil {
d.original.Handle(ctx, entry)
}
}
func main() {
// 获取默认的全局 Handler
defaultHandler := glog.GetHandler()
// 包装并注册
glog.SetHandler(NewColorDecorator(defaultHandler))
glog.Info("保留文件输出的同时增加控制台颜色")
glog.Error("错误日志也会记录到文件")
}
这种方式的优势在于不破坏 GoFrame 内置的日志管理特性。通过 IsConsoleOutput() 判断当前环境,确保只在终端运行时应用 ANSI 颜色,避免在日志文件中写入不可见的控制字符。开发者可以根据实际需求调整颜色映射和输出格式。
当日志级别为 Debug 时颜色表现如何
在上述自定义 Handler 的实现中,如果日志级别为 Debug,由于 switch 语句中没有对应的 case,颜色变量将保持默认值 "\033[0m"(即无颜色/白色)。这意味着 Debug 级别的日志将以默认终端颜色输出,不会像 Info、Warn 或 Error 那样被高亮显示。若需为 Debug 级别添加特定颜色(如灰色),只需在 switch 中添加 case glog.LevelDebug: 并设置相应的 ANSI 码即可。











