Golang日志记录教程：log包使用详解

一分耕耘，一分收获！既然都打开这篇《Golang日志记录指南：使用log包详解》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新Golang相关的内容，希望对大家都有所帮助！

答案：Go标准库log包提供基础日志功能，通过log.Print输出信息，SetPrefix设置前缀，SetFlags配置时间、文件等格式，SetOutput重定向到文件，默认输出到stderr，支持Fatal和Panic级别，适用于简单场景。

Go语言标准库中的log包提供了简单而有效的日志记录功能，适合大多数基础场景。使用它不需要引入第三方依赖，开箱即用。

基本日志输出

最简单的使用方式是调用log.Print、log.Printf或log.Println来输出信息：

package main
import "log"
func main() {
log.Print("这是一条普通日志")
log.Printf("用户 %s 登录失败", "alice")
log.Println("系统启动完成")
}

默认输出格式包含时间戳、文件名和行号（如果启用了相应设置）。

自定义日志前缀和标志

可以通过log.SetPrefix和log.SetFlags来自定义日志的格式：

• SetPrefix：设置每条日志前的前缀，比如模块名
• SetFlags：控制输出中包含哪些元信息

log.SetPrefix("[APP] ")
log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)
log.Println("服务已启动")

常见标志包括：

• log.Ldate - 输出日期（2025/04/05）
• log.Ltime - 输出时间（14:30:45）
• log.Lmicroseconds - 精确到微秒
• log.Lshortfile - 输出调用日志的文件名和行号
• log.Llongfile - 输出完整路径文件名和行号
• log.LUTC - 使用UTC时间

写入文件而不是终端

默认日志输出到标准错误os.Stderr。要写入文件，需使用log.SetOutput：

file, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
if err != nil {
    log.Fatal("无法打开日志文件:", err)
}
log.SetOutput(file)
log.Println("这条日志会写入文件")

注意在生产环境中应考虑日志轮转（可通过外部工具如logrotate实现）。

致命日志与恐慌日志

log包还提供两个特殊函数：

• log.Fatal：输出日志后调用os.Exit(1)
• log.Panic：输出日志后触发panic

// 示例：配置加载失败
if config == nil {
    log.Fatal("配置文件解析失败")
}

这两个函数适用于不可恢复的错误场景。

对于更复杂的需求，比如分级日志（debug/info/warn/error）、JSON格式输出或多目标输出，建议使用第三方库如zap、logrus等。但标准log包在多数小项目中已经足够用，且性能良好，无额外依赖。

基本上就这些。掌握Print、SetFlags、SetPrefix和SetOutput这几个核心方法，就能满足日常开发中的基本日志需求。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。