gin默认日志不支持直接写入文件并轮转，因gin.defaultwriter指向os.stdout；需用io.multiwriter包装缓冲文件写入器（os.o_create|o_wronly|o_append打开+bufio.newwriter）并配合lumberjack实现线程安全与自动轮转。
为什么默认日志不能直接写入文件
Gin 的 gin.DefaultWriter 默认指向 os.Stdout，它不支持直接重定向到文件句柄并自动轮转。你用 gin.SetMode(gin.ReleaseMode) 后，日志仍会输出到终端，除非显式替换 gin.DefaultWriter —— 但简单赋值一个 *os.File 会导致并发写入冲突、无缓冲、无格式控制等问题。
用 io.MultiWriter 同时输出到文件和控制台
最轻量且安全的做法是用 io.MultiWriter 包装多个 io.Writer，让 Gin 日志既落盘又可见。注意：必须确保文件以 os.O_CREATE | os.O_WRONLY | os.O_APPEND 打开，并设置缓冲（否则小日志频繁 syscall 性能差）。
- 不要直接用
os.OpenFile返回的裸*os.File，先套一层bufio.NewWriter - 在程序退出前调用
bufWriter.Flush()，否则最后一段日志可能丢失 - 如果只想要文件输出，把
os.Stdout换成io.Discard
file, _ := os.OpenFile("gin.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
bufWriter := bufio.NewWriter(file)
gin.DefaultWriter = io.MultiWriter(bufWriter, os.Stdout) // 或仅 bufWriter
defer file.Close()
defer bufWriter.Flush() // 关键：必须 defer 在 main return 前
自定义日志格式需替换 gin.LoggerWithWriter
Gin 的中间件 gin.Logger() 本身不支持格式定制；真正可控的是 gin.LoggerWithWriter，它接受一个 io.Writer 和可选的 gin.LoggerConfig。格式由 gin.LoggerConfig 中的 Format 字段决定，它是 Go 的 fmt.Stringer 风格模板字符串，支持如下字段：{{.Status}}、{{.Latency}}、{{.ClientIP}}、{{.Method}}、{{.Path}} 等。
-
Format字符串末尾要加\n，否则多条日志会挤在同一行 - 时间字段用
{{.Time}}（带空格）避免与后续内容粘连 - 若需毫秒级精度，用
{{.Latency}}（自带单位），别用{{.Latency}}.Seconds—— 这个字段不存在
logFile, _ := os.OpenFile("access.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
gin.DefaultWriter = logFile
r.Use(gin.LoggerWithWriter(logFile, gin.LoggerConfig{
Format: "[{{.Time}}] {{.Status}} {{.Method}} {{.Path}} {{.Latency}} {{.ClientIP}}\n",
}))
生产环境必须考虑日志轮转和并发安全
上面方案能跑通，但上线后会遇到两个硬伤：文件无限增长、多 goroutine 写同一文件句柄导致内容错乱。Gin 本身不提供轮转能力，必须借助第三方库或自己封装。推荐用 lumberjack —— 它是官方 log 包常用搭配，线程安全，支持按大小/时间切割。
- 替换
os.OpenFile为&lumberjack.Logger{}实例，其余逻辑不变 -
lumberjack的MaxSize单位是 MB，不是字节；MaxBackups是保留几个旧文件 - 注意：
lumberjack.Logger实现了io.WriteCloser，但Flush()方法是空实现，不用 defer 调用
import "gopkg.in/natefinch/lumberjack.v2"
// ...
writer := &lumberjack.Logger{
Filename: "gin-access.log",
MaxSize: 10, // MB
MaxBackups: 5,
MaxAge: 28, // days
}
r.Use(gin.LoggerWithWriter(writer, ...))
文件权限、路径不存在、磁盘满这些基础问题不会因用了 Gin 就消失，lumberjack 也只负责写，不负责创建父目录 —— 你得自己 os.MkdirAll。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
