Go 标准库 log 默认不支持环境区分，需用 slog（Go 1.21+）或封装实现：开发用 TextHandler（AddSource=true），生产用 JSONHandler（AddSource=false）；环境变量 ENV 必须运行时注入并设 fallback。
Go 标准库 log 默认不支持环境区分
Go 自带的 log 包没有内置 Development/Production 模式切换，也不自动添加时间、调用位置或结构化字段。直接用 log.Println() 输出的日志在生产环境难以排查问题，且无法按环境控制输出格式或级别。
常见错误是试图用 log.SetFlags() 拼凑出“环境感知”日志，比如只在开发时加 log.Lshortfile，但这样会导致代码分支多、配置散落、易遗漏。
- 真正需要的是统一入口 + 环境变量驱动的行为差异
- 推荐用
os.Getenv("ENV")或命令行 flag 读取环境标识，而非硬编码判断 - 避免在每个
log.PrintXxx()前写if env == "dev"
用 log/slog（Go 1.21+）实现环境自适应日志
slog 是 Go 官方推荐的结构化日志替代方案，支持 Handler 抽象，可为不同环境注册不同输出逻辑。它天然适配环境配置，无需第三方依赖。
关键点在于：开发环境用 slog.NewTextHandler（可读、带源码位置），生产环境用 slog.NewJSONHandler（机器友好、无换行干扰）。
立即学习“go语言免费学习笔记（深入）”；
env := os.Getenv("ENV")
var handler slog.Handler
switch env {
case "production":
handler = slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{AddSource: false})
default:
handler = slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{AddSource: true, Level: slog.LevelDebug})
}
logger := slog.New(handler)
slog.SetDefault(logger)
-
AddSource: true在开发时显示file:line，生产环境务必关掉，避免性能损耗和敏感路径泄露 -
Level控制默认最低日志级别，开发可设为Debug，生产建议Info或更高 - 所有后续
slog.Info()、slog.Error()都自动走该 handler，无需改业务代码
兼容旧项目：封装 log 实现简易环境路由
若项目仍用 log 包且暂不能升级到 slog，可通过包装器模拟环境行为。重点不是重写日志逻辑，而是统一输出目标和前缀。
不要直接修改全局 log.Logger，而应导出一个可配置的 Logger 实例：
type Logger struct {
*log.Logger
env string
}
func NewLogger(env string) *Logger {
out := os.Stdout
if env == "production" {
out = os.Stderr // 生产日志走 stderr 是惯例
}
l := log.New(out, "["+env+"] ", log.LstdFlags|log.LUTC)
if env == "development" {
l.SetFlags(l.Flags() | log.Lshortfile)
}
return &Logger{Logger: l, env: env}
}
func (l *Logger) Debug(v ...interface{}) {
if l.env == "development" {
l.Printf("[DEBUG] %v", v)
}
}
- 注意
log.Lshortfile会显著拖慢日志性能，仅限开发启用 - 生产环境避免用
log.Llongfile或log.Lshortfile，否则每条日志都触发 runtime.Caller - 如需级别控制（如跳过
Debug），必须自己实现判断逻辑，标准log不支持
环境变量名和部署时的典型坑
用 ENV 作环境标识最常见，但容易被忽略的是：Docker 容器、K8s Pod、systemd 服务中该变量是否真实注入？很多线上问题其实只是 os.Getenv("ENV") 返回空字符串，导致日志退化成默认行为。
- 始终提供 fallback：比如
env := os.Getenv("ENV"); if env == "" { env = "development" } - K8s 中记得在
Deployment的env:下显式声明，不能只靠镜像内建值 - Docker run 时用
-e ENV=production，别依赖.env文件（Go 不自动加载） - CI/CD 构建阶段设置的环境变量，不会透传到运行时，必须在启动容器时重新注入
真正麻烦的从来不是怎么写日志，而是确保那个 ENV 字符串在进程启动那一刻就存在且正确。
