完整的方法列表可参考接口文档： https://pkg.go.dev/github.com/gogf/gf/v2/os/glog

glog 模块支持非常简便的 链式操作 方式，主要的链式操作方法如下：

  1. // 重定向日志输出接口
  2. func To(writer io.Writer) *Logger
  3. // 日志内容输出到目录
  4. func Path(path string) *Logger
  5. // 设置日志文件分类
  6. func Cat(category string) *Logger
  7. // 设置日志文件格式
  8. func File(file string) *Logger
  9. // 设置日志打印级别
  10. func Level(level int) *Logger
  11. // 设置日志打印级别(字符串)
  12. func LevelStr(levelStr string) *Logger
  13. // 设置文件回溯值
  14. func Skip(skip int) *Logger
  15. // 是否开启trace打印
  16. func Stack(enabled bool) *Logger
  17. // 开启trace打印并设定过滤trace的字符串
  18. func StackWithFilter(filter string) *Logger
  19. // 是否开启终端输出
  20. func Stdout(enabled...bool) *Logger
  21. // 是否输出日志头信息
  22. func Header(enabled...bool) *Logger
  23. // 输出日志调用行号信息
  24. func Line(long...bool) *Logger
  25. // 异步输出日志
  26. func Async(enabled...bool) *Logger

示例1, 基本使用

  1. package main
  3. import (
  4.     "context"
  6.     "github.com/gogf/gf/v2/frame/g"
  7.     "github.com/gogf/gf/v2/os/gfile"
  8. )
  10. func main() {
  11.     ctx := context.TODO()
  12.     path := "/tmp/glog-cat"
  13.     g.Log().SetPath(path)
  14.     g.Log().Stdout(false).Cat("cat1").Cat("cat2").Print(ctx, "test")
  15.     list, err := gfile.ScanDir(path, "*", true)
  16.     g.Dump(err)
  17.     g.Dump(list)
  18. }

执行后，输出结果为：

  1. [
  2.     "/tmp/glog-cat/cat1",
  3.     "/tmp/glog-cat/cat1/cat2",
  4.     "/tmp/glog-cat/cat1/cat2/2018-10-10.log",
  5. ]

示例2, 打印调用行号

  1. package main
  3. import (
  4.     "context"
  6.     "github.com/gogf/gf/v2/frame/g"
  7. )
  9. func main() {
  10.     ctx := context.TODO()
  11.     g.Log().Line().Print(ctx, "this is the short file name with its line number")
  12.     g.Log().Line(true).Print(ctx, "lone file name with line number")
  13. }

执行后，终端输出结果为：

  1. 2019-05-23 09:22:58.141 glog_line.go:8: this is the short file name with its line number
  2. 2019-05-23 09:22:58.142 /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/.example/os/glog/glog_line.go:9: lone file name with line number

示例3, 文件回溯 Skip

有时我们通过一些模块封装了 glog 模块来打印日志，例如封装了一个 logger 包通过 logger.Print 来打印日志，这个时候打印出来的调用文件行号总是同一个位置，因为对于 glog 来讲，它的调用方即总是 logger.Print 方法。这个时候，我们可以通过设置回溯值来跳过回溯的文件数，使用 SetStackSkip 或者链式方法 Skip 实现。

文件回溯值的设置同样也会影响 Stack 调用回溯打印结果。

  1. package main
  3. import (
  4.     "context"
  6.     "github.com/gogf/gf/v2/frame/g"
  7. )
  9. func PrintLog(ctx context.Context, content string) {
  10.     g.Log().Skip(1).Line().Print(ctx, "line number with skip:", content)
  11.     g.Log().Line().Print(ctx, "line number without skip:", content)
  12. }
  14. func main() {
  15.     ctx := context.TODO()
  16.     PrintLog(ctx, "just test")
  17. }

执行后，终端输出结果为：

  1. 2019-05-23 19:30:10.984 glog_line2.go:13: line number with skip: just test
  2. 2019-05-23 19:30:10.984 glog_line2.go:9: line number without skip: just test