Go语言日志前缀设置详解（log包自动添加日志前缀的完整教程）

什么是 log 包？

log 是 Go 语言标准库中用于记录日志的轻量级工具。它默认输出到标准错误（stderr），但也可以重定向到文件或其他输出流。通过设置前缀（prefix）和标志（flags），我们可以自定义日志格式。

如何自动添加日志前缀？

Go 的 log 包提供了 SetPrefix 函数，可以为所有后续日志消息统一添加前缀。此外，你还可以使用 New 函数创建带前缀的独立 logger 实例，适用于多模块日志隔离。

方法一：使用 SetPrefix 全局设置

package mainimport (    "log")func main() {    // 设置全局日志前缀    log.SetPrefix("[API-SERVER] ")    // 输出日志    log.Println("服务已启动")    log.Println("处理用户请求")}

运行上述代码，输出结果如下：

[API-SERVER] 2024/06/15 10:30:45 服务已启动[API-SERVER] 2024/06/15 10:30:45 处理用户请求

可以看到，每条日志都自动加上了 [API-SERVER] 前缀。这就是 Go语言日志管理 中最基础也最实用的功能之一。

方法二：使用 log.New 创建独立 Logger

如果你有多个模块（如数据库、缓存、HTTP 服务），建议为每个模块创建独立的 logger，避免全局污染。

package mainimport (    "log"    "os")func main() {    // 为数据库模块创建 logger    dbLogger := log.New(os.Stdout, "[DB] ", log.LstdFlags)    // 为 HTTP 服务创建 logger    httpLogger := log.New(os.Stdout, "[HTTP] ", log.LstdFlags|log.Lshortfile)    dbLogger.Println("连接数据库成功")    httpLogger.Println("收到 GET 请求")}

输出示例：

[DB] 2024/06/15 10:35:12 连接数据库成功[HTTP] 2024/06/15 10:35:12 main.go:17: 收到 GET 请求

注意：第三个参数是日志标志（flags），log.LstdFlags 表示包含日期和时间，log.Lshortfile 会显示文件名和行号。

常用日志标志（Flags）说明

• log.Ldate：输出日期（如 2024/06/15）
• log.Ltime：输出时间（如 10:30:45）
• log.Lmicroseconds：输出微秒
• log.Llongfile：完整文件路径和行号
• log.Lshortfile：仅文件名和行号（推荐）
• log.LUTC：使用 UTC 时间

小贴士：结合环境变量动态设置前缀

在实际项目中，你可能希望根据部署环境（开发、测试、生产）自动调整日志前缀。可以通过读取环境变量实现：

package mainimport (    "log"    "os")func main() {    env := os.Getenv("APP_ENV")    if env == "" {        env = "development"    }    prefix := fmt.Sprintf("[%s] ", strings.ToUpper(env))    log.SetPrefix(prefix)    log.Println("应用启动中...")}

总结

通过本文，你已经掌握了 Go语言日志前缀 的两种核心设置方式：SetPrefix 全局配置和 log.New 创建独立 logger。这不仅提升了日志可读性，也为后续的日志分析和监控打下基础。无论是小型脚本还是大型服务，合理使用 log包使用教程 中介绍的方法，都能让你的 Go自动添加日志前缀 更加高效规范。

记住：良好的日志习惯是专业开发者的必备技能！