Go 标准库 log 不支持日志级别,仅提供 Print/Fatal/Panic 等函数,无 Info/Warn/Error 分级;需用第三方库(如 logrus、zap)或自行封装前缀式 Logger。

Go 标准库 log 本身不支持日志级别
这是最容易踩的坑:Go 原生 log 包没有 Info、Warn、Error 等分级接口。它只提供 Print、Printf、Println、Fatal、Fatalf、Panic、Panicf 这几组函数,其中只有 Fatal 和 Panic 会终止程序,其余都只是输出——它们在语义上并无级别区分。
如果你看到别人代码里写了 log.Info(...),那一定是用了第三方库(比如 logrus、zap 或 zerolog),不是标准库。
-
log.Println():输出后换行,不退出进程 -
log.Fatal():等价于log.Println()+os.Exit(1),输出后立即终止程序 -
log.Panic():等价于log.Println()+panic(...),触发 panic,可被recover捕获(但一般不这么用)
如何模拟日志级别(轻量方案)
如果不想引入第三方库,又想区分日志用途,常见做法是封装自己的 Logger 类型,用前缀或不同输出目标来区分:
package main
import (
"log"
"os"
)
var (
InfoLogger = log.New(os.Stdout, "[INFO] ", log.Ldate|log.Ltime|log.Lshortfile)
ErrorLogger = log.New(os.Stderr, "[ERROR] ", log.Ldate|log.Ltime|log.Lshortfile)
FatalLogger = log.New(os.Stderr, "[FATAL] ", log.Ldate|log.Ltime|log.Lshortfile)
)
func main() {
InfoLogger.Println("服务启动完成")
ErrorLogger.Printf("数据库连接失败: %v", "timeout")
FatalLogger.Fatal("配置文件不存在,无法继续")
}
注意:log.New 的第三个参数是 flag,常用组合如 log.Ldate | log.Ltime | log.Lshortfile,能帮你快速定位日志来源;不要漏掉 |,写成逗号会编译失败。
立即学习“go语言免费学习笔记(深入)”;
- 把
InfoLogger输出到os.Stdout,方便管道处理或重定向到文件 - 把
ErrorLogger和FatalLogger输出到os.Stderr,符合 Unix 习惯,也便于分离错误流 -
FatalLogger.Fatal()仍会调用os.Exit(1),不可恢复
Fatal 不是 “严重错误日志”,而是 “程序必须退出” 的信号
很多人误以为 log.Fatal 是用来记录“高危错误”的,其实它核心语义是“这个错误发生后,程序已无法安全继续运行”。比如:
- 监听端口失败且无备选方案
- 加载必要配置失败(如 JWT 密钥为空)
- 初始化全局数据库连接池失败
相反,以下情况不该用 Fatal:
- HTTP 请求处理中数据库查询失败(应返回 500 并记录 error 日志)
- 用户上传文件格式错误(应返回 400)
- 第三方 API 调用超时(应降级或重试)
滥用 Fatal 会导致服务频繁崩溃,尤其在微服务或容器环境中,可能触发反复重启循环。
真正需要分级时,直接换库比自己造轮子更稳妥
标准库 log 的设计哲学是“足够简单”,它不打算替代专业日志系统。一旦项目规模上升、需要如下能力,就该考虑迁移:
- 按级别动态控制输出(比如开发环境显示 debug,生产只显示 error)
- 结构化日志(JSON 输出,字段可被 ELK / Loki 解析)
- 日志采样、异步写入、滚动切片
- 上下文透传(
ctx中的 traceID 自动注入每条日志)
推荐起步选择:github.com/sirupsen/logrus(API 清晰,文档全)或 go.uber.org/zap(高性能,适合高吞吐场景)。它们都支持标准库风格的 log.WithField 或 logger.Info 调用,迁移成本低。
别花时间给 log 打补丁加 level 字段——Go 生态里,日志分级这件事,早有成熟解法,而且比你预想的更轻量。










