GoFrame日志配置需统一通过config.yaml/toml的logger节点设置path、file、level、stdout、header及format;运行时可用SetPath/SetFile链式调用或SetConfigWithMap为特定实例(如access、error)定制行为,且format支持{level}{datetime}{file}{line}等占位符,生产环境须设stdout:false并确保SetStdoutPrint(false)在首次日志输出前执行。

在GoFrame项目中配置日志,需同时控制输出目标(终端/文件)、路径、文件名格式、级别及内容结构,避免日志丢失或格式混乱导致排查困难。
通过配置文件统一管理日志行为
在项目根目录创建 config.yaml 或 config.toml,确保 【g.Log() 调用前已加载配置】。框架启动时会自动读取 logger 节点下的设置。
YAML 示例:
logger:
path: "./logs"
file: "{Y-m-d}.log"
level: "info"
stdout: true
header: false
format: "[{level}] {datetime} {file}:{line} - {message}"
注意:若未设置 path,日志仅输出到终端;若设置了 path 但未设 file,则默认按 {Y-m-d}.log 命名。
运行时动态调整单个日志实例
适用于调试阶段快速切换输出目标,或为特定模块(如 access、error)定制行为。
方法一:使用 SetPath + SetFile 链式调用
g.Log("access").SetPath("./logs/access").SetFile("access-{Ymd}.log").Info(ctx, "访问日志已就位")
方法二:直接传入配置 Map
g.Log("error").SetConfigWithMap(g.Map{
"path": "./logs/error",
"file": "error-{Y-m-d-H}.log",
"level": "error",
"stdout": false,
"format": "{datetime} [{level}] ERROR: {message}"
})
这一步操作起来很简单,直接把配置 Map 传进去就行。但要注意:【SetConfigWithMap 会影响该 Logger 实例后续所有日志输出】,不可逆。
强制指定日志输出格式与字段
自定义 format 字符串可精确控制每条日志的呈现方式,尤其适合对接 ELK 或日志审计系统。
第一步:确认支持的占位符
可用字段包括:{level}、{datetime}、{file}、{line}、{func}、{message}、{pid}、{tid}。其中 {file} 和 {line} 默认关闭,需显式启用 header: true 才生效。
第二步:覆盖默认格式
g.Log().SetConfigWithMap(g.Map{"format": "[{level}] {datetime} [{pid}] {file}:{line} → {message}"})
第三步:验证是否生效
执行 g.Log().Info(ctx, "test format"),检查输出是否包含文件名与行号。若仍无,说明 header 未开启或编译时禁用了调试信息。
禁用终端输出并只写入文件
生产环境必须关闭 stdout,否则容器日志会混杂标准输出与文件日志,造成重复和解析失败。
g.Log().SetStdoutPrint(false)
这行代码必须在首次调用 g.Log().Info() 之前执行。一旦日志已输出到终端,再调用此方法也无法撤回已打印的内容。
配合路径设置使用效果更明确:
g.Log().SetPath("./logs").SetStdoutPrint(false)

















