GO语言基础教程（179）Go记录日志之把日志输出到文件中：当日志开始“离家出走”：Go语言如何给日志找个文件安家？

一、日志的“流浪生涯”该结束了！

每次运行Go程序时，是不是经常看到终端里噼里啪啦冒出一堆日志？调试时它们是你的好帮手，但程序一跑起来，这些满屏乱飞的日志就像暑假在家捣乱的孩子——既碍眼又占地方。更糟的是，终端一关，所有操作记录瞬间“人间蒸发”，等到真要查问题的时候只能对着空荡荡的屏幕干瞪眼。

是时候给这些“流浪日志”找个稳定的家了！把日志写到文件里，就像是给程序配了个专属秘书，它会默默记录所有工作轨迹，随时等你翻牌查阅。今天咱们就彻底搞定Go语言里如何把日志优雅地请进文件这个技术活。

二、log包——你的第一个日志管家

Go语言自带的log包看起来平平无奇，实则是个隐藏的扫地僧。它可能没有Zap或Logrus那些炫酷功能，但对大多数项目来说已经完全够用。

初始化日志系统的正确姿势：

package main

import (
    "log"
    "os"
)

func main() {
    // 尝试创建或打开日志文件
    logFile, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
    if err != nil {
        log.Fatal("打开日志文件失败：", err)
    }
    defer logFile.Close()

    // 关键一步：告诉log包输出到哪里
    log.SetOutput(logFile)
    
    // 现在日志不会显示在终端，而是乖乖进文件了
    log.Println("系统启动成功！")
    log.Printf("当前用户：%s", "Go程序员")
}

看到那个os.OpenFile了吗？它用的三个参数可是暗藏玄机：

• os.O_CREATE：如果文件不存在，就创建一个新的，妥妥的“无中生有”
• os.O_WRONLY：以只写模式打开，给日志文件“只进不出”的设定
• os.O_APPEND：每次写入都追加到文件末尾，避免覆盖之前的记录

三、给日志穿上“定制工装”

默认的日志格式就像统一的工作服——实用但缺乏个性。咱们可以给它来点定制化改造：

func setupLogger() {
    logFile, _ := os.OpenFile("custom.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
    
    // 创建自定义logger实例
    myLogger := log.New(logFile, "我的App丨", log.Ldate|log.Ltime|log.Lshortfile)
    
    // 使用自定义logger
    myLogger.Println("这是定制版日志！")
    myLogger.Printf("CPU使用率：%.2f%%", 45.67)
}

这里的log.New就像是为日志系统量身定做服装：

• 第一个参数：指定输出目标（文件、终端、网络等都可以）
• 第二个参数：每行日志的前缀，相当于给日志盖了个专属印章
• 第三个参数：标志位组合，控制显示哪些信息

特别推荐log.Lshortfile这个标志，它会自动记录输出日志的文件名和行号，debug时能帮你快速定位问题，堪称“寻宝地图”。

四、当单个文件变成“胖大叔”——日志分割实战

想象一下，如果你的日志文件长到几个GB，打开它时电脑风扇开始呼啸，查找某条记录就像在春运火车站找一个人...是时候考虑日志分割了！

按文件大小分割：

func rotateLogBySize() {
    // 检查当前日志文件大小
    info, err := os.Stat("app.log")
    if err == nil && info.Size() > 100*1024*1024 { // 超过100MB就分割
        os.Rename("app.log", "app.log."+time.Now().Format("20060102150405"))
        // 创建新文件继续记录
    }
}

更实用的按日期分割：

func getLogFileName() string {
    return "logs/app_" + time.Now().Format("2006-01-02") + ".log"
}

func dailyLogger() {
    logFile, _ := os.OpenFile(getLogFileName(), os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
    logger := log.New(logFile, "", log.LstdFlags)
    
    logger.Println("这条日志会自动进入按日期命名的文件！")
}

建议把这类代码放在定时任务中，比如每天凌晨自动执行，实现“无人值守”的智能日志管理。

五、多频道日志——给信息分家

把错误日志和普通调试日志混在一起，就像把重要文件和垃圾邮件都塞进同一个抽屉。高级玩法是给它们分家：

var (
    InfoLogger  *log.Logger
    ErrorLogger *log.Logger
)

func initLoggers() {
    // 通用信息日志
    infoFile, _ := os.OpenFile("info.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
    InfoLogger = log.New(infoFile, "INFO: ", log.Ldate|log.Ltime)
    
    // 错误专用日志
    errorFile, _ := os.OpenFile("error.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
    ErrorLogger = log.New(errorFile, "ERROR: ", log.Ldate|log.Ltime|log.Lshortfile)
}

func processData() {
    InfoLogger.Println("开始处理用户请求")
    
    if err := someOperation(); err != nil {
        ErrorLogger.Printf("处理失败：%v", err)
    }
}

这样配置后，日常运行看info.log就够了，只有当出现问题时才需要去error.log里“精准抓捕”。

六、实战演练——完整示例登场

下面是一个即拿即用的完整示例，复制到你的项目里就能运行：

package main

import (
    "fmt"
    "log"
    "os"
    "time"
)

// 初始化日志系统
func initLogger() (*log.Logger, *log.Logger) {
    // 创建logs目录（如果不存在）
    os.Mkdir("logs", 0755)
    
    // 通用日志文件
    commonFile, err := os.OpenFile("logs/application.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
    if err != nil {
        log.Fatal(err)
    }
    
    // 错误日志文件
    errorFile, err := os.OpenFile("logs/errors.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
    if err != nil {
        log.Fatal(err)
    }
    
    // 创建两个logger实例
    commonLogger := log.New(commonFile, "APP丨", log.Ldate|log.Ltime)
    errorLogger := log.New(errorFile, "ERROR丨", log.Ldate|log.Ltime|log.Lshortfile)
    
    return commonLogger, errorLogger
}

func main() {
    fmt.Println("启动日志演示程序...")
    
    commonLog, errorLog := initLogger()
    
    // 模拟各种日志场景
    commonLog.Println("应用程序启动完成")
    
    for i := 1; i <= 5; i++ {
        commonLog.Printf("处理第 %d 个任务", i)
        
        // 模拟偶尔发生的错误
        if i%3 == 0 {
            errorLog.Printf("在处理任务 %d 时遇到问题", i)
        }
        
        time.Sleep(1 * time.Second)
    }
    
    commonLog.Println("程序正常退出")
    fmt.Println("演示完成，请查看logs目录下的日志文件！")
}

运行这个程序后，你的项目目录里会出现：

• logs/application.log：记录所有运行信息
• logs/errors.log：专门收集错误信息

七、避坑指南与进阶技巧

1. 文件权限陷阱：Linux系统下注意日志文件的写入权限，特别是当程序以不同用户身份运行时。
2. 并发写入安全：多个goroutine同时写日志时，log包默认是线程安全的，但自定义logger需要注意加锁。
3. 性能优化：频繁写入小日志可能影响性能，可以考虑使用bufio缓冲：

writer := bufio.NewWriter(logFile)
logger := log.New(writer, "", log.LstdFlags)
// 需要定期调用writer.Flush()确保数据写入磁盘

1. 日志清理：记得给日志文件设置保留策略，避免磁盘被陈年日志占满。

八、总结

给Go程序的日志找个文件安家，就像是给漂泊的游子买了套房——既安心又实用。从最简单的单文件记录，到带分割、分级的高级用法，这套日志管理体系足以应对大多数应用场景。

记住，好的日志习惯就像记日记，平时可能觉得繁琐，但在关键时刻绝对能救你一命。现在就去给你的Go程序配个专属日志管家吧！

---

小贴士：完整示例代码已经过测试，直接复制到.go文件中，运行go run main.go即可体验效果。记得检查生成的logs文件夹，你的程序“日记本”就在那里等着你翻阅呢！