从使用标准库log输出带时间戳的日志并重定向到文件开始，逐步引入logrus等第三方库实现结构化日志与多级别控制，结合环境变量区分开发与生产日志级别，通过日志分级、字段附加和定期轮转，提升Go项目的可观测性与维护效率。
在Golang初级项目中，日志记录是保障程序可维护性和排查问题的基础手段。很多初学者容易忽略日志的重要性，或者随意使用
fmt.Println输出信息，导致后期难以追踪错误和分析系统行为。合理的日志实践能显著提升项目的可观测性。
使用标准库log进行基础日志输出
Go的
log包是入门最简单的日志工具，适合小型项目或学习阶段。
你可以通过以下方式设置输出格式和目标：
- 使用
log.SetFlags
添加时间戳、文件名等上下文信息 - 将日志输出重定向到文件而非控制台，便于长期保留
- 按级别简单区分，如用
log.Println
表示普通信息，log.Fatalf
表示致命错误
log.SetFlags(log.LstdFlags | log.Lshortfile)
log.SetOutput(&os.File{...}) // 输出到文件
log.Println("服务启动成功")
引入第三方日志库提升可读性与控制力
当项目功能增多，建议使用如
logrus或
zap这类功能更丰富的日志库。
立即学习“go语言免费学习笔记（深入）”；
以
logrus为例，它支持结构化日志、多级别输出（debug、info、warn、error）和自定义hook。
- 结构化日志便于后期分析，例如输出JSON格式日志
- 通过
WithField
或WithFields
附加上下文，如请求ID、用户ID - 开发环境使用文本格式，生产环境切换为JSON格式
log := logrus.New()
log.SetFormatter(&logrus.JSONFormatter{})
log.WithFields(logrus.Fields{
"userID": "123",
"action": "login",
}).Info("用户登录")
日志分级与环境区分策略
不同运行环境对日志的需求不同。本地开发需要详细日志辅助调试，生产环境则需控制输出量避免性能损耗。
- 设置日志级别：开发用
DebugLevel
，生产用InfoLevel
或ErrorLevel
- 通过配置文件或环境变量动态控制日志级别
- 避免在循环中打印高频日志，可聚合或采样输出
比如通过
os.Getenv("LOG_LEVEL")读取配置，并设置对应等级。
简单日志分析方法
即使没有ELK等复杂系统，也能通过简单手段做初步分析。
- 将日志按日期分割，使用
rotatelogs
等工具自动归档 - 关键操作记录结构化字段，方便用
grep
、awk
或脚本提取统计信息 - 记录HTTP请求时，可输出耗时、状态码、路径等，用于性能观察
例如搜索所有错误日志：
grep '"level":"error"' app.log
基本上就这些。从
log包起步，逐步过渡到结构化日志，结合分级和输出控制，就能满足大多数初级项目的需求。关键是养成规范写日志的习惯，而不是到处打
fmt。不复杂但容易忽略。
