掌握Go语言日志时间戳格式（log包自定义时间格式详解）

1. Go log包默认的时间戳格式

首先，我们来看一下不加任何设置时，log 包输出的日志是什么样子：

package mainimport "log"func main() {    log.Println("这是一条测试日志")}

运行后，输出可能如下：

2024/06/15 10:30:45 这是一条测试日志

可以看到，默认时间戳格式为：2006/01/02 15:04:05。这是Go语言中一个特殊的“参考时间”，用于格式化时间。

2. 为什么是2006/01/02 15:04:05？

Go语言使用一个固定的“布局时间”作为格式模板：Mon Jan 2 15:04:05 MST 2006，对应的是Unix时间 1136239445。这个时间点被选作格式参考是因为它包含了所有时间字段且数字顺序清晰（年=2006，月=01，日=02，时=15，分=04，秒=05）。

3. 自定义日志时间戳格式

要修改 log 包的时间戳格式，我们需要使用 log.SetFlags() 和 log.SetPrefix()，但更重要的是通过 log.New() 创建自定义 Logger，并配合 time.Format() 来实现完全控制。

不过，log 包本身并不直接支持自定义时间格式字符串。但我们可以通过关闭默认时间戳，然后手动在日志消息前添加格式化后的时间来实现。

方法一：关闭默认时间戳 + 手动添加

package mainimport (    "log"    "time")func main() {    // 关闭默认的时间戳    log.SetFlags(0)    now := time.Now().Format("2006-01-02 15:04:05")    log.Printf("[%s] 这是一条自定义时间格式的日志", now)}

输出结果：

[2024-06-15 10:35:22] 这是一条自定义时间格式的日志

方法二：封装一个带自定义时间格式的日志函数

package mainimport (    "fmt"    "log"    "os"    "time")var customLogger = log.New(os.Stdout, "", 0)func Logf(format string, v ...interface{}) {    timestamp := time.Now().Format("2006-01-02 15:04:05.000")    msg := fmt.Sprintf(format, v...)    customLogger.Printf("[%s] %s", timestamp, msg)}func main() {    Logf("用户 %s 登录成功", "Alice")    Logf("处理请求耗时 %v 毫秒", 125)}

输出：

[2024-06-15 10:40:15.321] 用户 Alice 登录成功[2024-06-15 10:40:15.322] 处理请求耗时 125 毫秒

4. 常见时间格式示例

以下是几种常用的 Go日志输出时间 格式，你可以根据项目需求选择：

• 2006-01-02 15:04:05 → 2024-06-15 10:45:30
• 2006/01/02 15:04:05.000 → 2024/06/15 10:45:30.123
• Jan _2 15:04:05 → Jun 15 10:45:30
• 2006-01-02T15:04:05Z07:00（RFC3339）→ 2024-06-15T10:45:30+08:00

5. 小结

虽然 Go 标准库的 log 包默认时间戳格式固定，但通过关闭默认标志并手动添加格式化时间，我们可以灵活控制 Go语言日志时间戳格式。这对于构建符合团队规范或满足特定日志分析工具要求的日志系统非常有用。

如果你需要更强大的日志功能（如日志级别、结构化日志、文件轮转等），可以考虑使用第三方库如 zap、logrus 或 slog（Go 1.21+ 内置）。但在轻量级场景下，标准 log 包配合自定义时间格式已经足够强大。

希望这篇 Go语言日志教程 能帮助你更好地理解和控制日志输出！