17370845950

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，能帮你快速定位日志来源；不要漏掉 |，写成逗号会编译失败。

• 把 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 生态里，日志分级这件事，早有成熟解法，而且比你预想的更轻量。