Golang中记录日志需结合标准库或第三方库实现文件写入。首先使用os.OpenFile将log输出重定向到文件，注意追加模式与权限设置；对于高性能需求，选用zap或logrus支持结构化日志，zap通过配置OutputPaths写入文件并生成JSON格式；logrus则直接设置Out为文件对象；为避免日志过大，引入lumberjack实现轮转，设置单文件大小、保留数量及保存天数；同时需确保目录存在、分离错误日志、禁用敏感信息输出，并根据环境调整日志级别以平衡性能与调试需求。
在 Golang 开发中，记录日志是调试、监控和排查问题的重要手段。合理地将日志写入文件，有助于长期追踪系统行为。Go 标准库提供了基础的日志能力，结合第三方库可以实现更灵活的文件写入策略。
使用标准库 log 写入文件
Go 的 log 包简单易用，适合中小型项目。通过指定输出目标，可将日志写入文件而非默认的控制台。
基本做法是打开一个文件，并将 *os.File 作为 log 的输出目标：
file, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
if err != nil {
log.Fatal("无法打开日志文件:", err)
}
defer file.Close()
log.SetOutput(file)
log.Println("这是一条日志信息")
这段代码会将日志追加写入 app.log 文件。注意设置 os.O_APPEND 避免覆盖已有内容，并使用 0666 权限确保可读写。
立即学习“go语言免费学习笔记（深入）”；
使用第三方库：zap 或 logrus
当项目对日志性能或格式有更高要求时，推荐使用 zap（Uber）或 logrus（Sirupsen）。它们支持结构化日志、多输出目标和分级日志。
以 zap 为例，配置写入文件的步骤如下：
config := zap.NewProductionConfig()
config.OutputPaths = []string{"logs/app.log"}
logger, _ := config.Build()
defer logger.Sync()
logger.Info("用户登录成功", zap.String("user", "alice"))
这段代码会生成 JSON 格式的日志并写入 logs/app.log。zap 支持自动创建目录、按级别分离日志、日志轮转等高级功能。
若想使用 logrus，可通过 hook 将日志写入文件：
log := logrus.New()
file, _ := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
log.Out = file
log.Info("使用 logrus 写入文件")
实现日志轮转（Log Rotation）
长时间运行的服务会产生大量日志，需定期切割避免单个文件过大。常用方案是结合 lumberjack 实现自动轮转。
lumberjack 可作为 io.Writer 与 log、zap 或 logrus 配合使用：
import "gopkg.in/natefinch/lumberjack.v2"
log.SetOutput(&lumberjack.Logger{
Filename: "logs/app.log",
MaxSize: 10, // 每个文件最大 10MB
MaxBackups: 5, // 保留最多 5 个旧文件
MaxAge: 7, // 文件最长保存 7 天
Compress: true, // 启用压缩
})
这样当日志文件达到设定大小时，会自动重命名并创建新文件，旧文件按规则清理。
注意事项与最佳实践
写入日志文件时需关注以下几点：
- 确保日志目录存在，程序启动时可尝试创建
- 错误日志应单独写入，便于快速定位问题
- 生产环境避免频繁 Sync，影响性能
- 敏感信息如密码、token 不应写入日志
- 测试阶段启用详细日志，线上适当降低级别
基本上就这些。Golang 写入日志文件不复杂但容易忽略细节，选对工具并合理配置才能发挥最大作用。
