关闭 debug 日志需在 gin.default() 前调用 gin.setmode(gin.releasemode) 或设 gin_mode=release；自定义日志须用 gin.new() + gin.loggerwithformatter；跳过健康检查路径需用 gin.loggerwithconfig 并指定 skippaths；写文件前必须先调用 gin.disableconsolecolor()。
关闭 DEBUG 日志避免路由注册刷屏
启动时大量 [GIN-debug] 输出（如 [GIN-debug] GET /ping --> main.main.func1 (3 handlers)）不是运行时请求日志，而是 Gin 初始化阶段的路由注册快照。它不参与请求处理流程，纯属开发期提示，上线后必须关掉。
直接调用 gin.SetMode(gin.ReleaseMode) 即可全局禁用所有 [GIN-debug] 行；若已在环境变量中设 GIN_MODE=release，则无需额外代码。注意：该设置必须在 gin.Default() 或 gin.New() 之前执行，否则无效。
- 没关 debug 模式时，即使后续替换
DefaultWriter，这些调试行仍会输出到控制台（或你指定的 writer） -
gin.ReleaseMode不影响gin.Logger()中间件产生的访问日志，只屏蔽框架内部初始化信息 - 某些 IDE 或容器环境会缓存 stdout，导致关 mode 后仍看到残留输出——重启进程才能彻底清空
替换默认 Logger 中间件实现精简格式
Gin 的 gin.Logger() 默认输出包含颜色、响应时间、状态码、IP、路径等字段，但字段顺序和冗余空格不利于日志采集系统解析。要精简，得自己构造 gin.LoggerWithFormatter。
关键点在于：不要用 gin.Default()，改用 gin.New() 手动挂载中间件，并传入自定义 formatter 函数：
func customLogFormatter(param gin.LogFormatterParams) string {
return fmt.Sprintf("%s | %d | %v | %s %s\n",
param.TimeStamp.Format("2006-01-02T15:04:05Z"),
param.StatusCode,
param.Latency,
param.Method,
param.Path,
)
}
- 去掉 IP、User-Agent、Referer 等非必要字段，减少单行日志体积
- 用
TimeStamp.Format统一时间格式，避免依赖本地时区造成解析错乱 - 末尾保留换行符
\n，否则多条日志会粘连成一行 - 别在 formatter 里做耗时操作（如 JSON 序列化、网络调用），它在每次请求结束时同步执行
跳过健康检查等高频路径减少日志噪音
/healthz、/readyz、/metrics 这类接口每秒被轮询多次，全量记录会快速撑爆磁盘或干扰真实业务日志。Gin 提供 SkipPaths 机制，但仅对 gin.LoggerWithConfig 生效。
正确写法是显式构造 gin.LoggerConfig 并传入 SkipPaths 切片：
router.Use(gin.LoggerWithConfig(gin.LoggerConfig{
SkipPaths: []string{"/healthz", "/readyz", "/metrics"},
Formatter: customLogFormatter,
}))
-
SkipPaths匹配的是完整路径字符串，不支持通配符或正则，"/health"不会跳过/healthz - 如果用了分组路由（如
v1 := router.Group("/api/v1")），需写完整路径"/api/v1/healthz" - 跳过路径后，对应请求仍会走其他中间件（如鉴权、限流），只是不记访问日志
文件写入时禁用 ANSI 颜色避免乱码
即使关了 debug 模式，gin.Logger() 默认仍启用终端颜色（ANSI 转义序列），一旦写入文件就会出现 \x1b[32m 类乱码，grep 和日志平台无法识别。
必须在创建日志文件前调用 gin.DisableConsoleColor()，且该调用需早于任何 gin.*Writer 设置：
f, _ := os.OpenFile("access.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
gin.DisableConsoleColor() // 必须在这一步之前
gin.DefaultWriter = io.MultiWriter(f, os.Stdout)
- 顺序错了就白设：先设 writer 再 disable color，颜色已写进 buffer，无法回滚
- 如果用
io.MultiWriter(f, os.Stdout)同时输出到文件和终端，终端仍能正常显示颜色，只有文件无乱码 - 某些旧版 Gin（DisableConsoleColor() 返回值是否为 true
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
