Go语言日志输出详解（手把手教你用log包自定义日志输出位置）

一、为什么需要自定义日志输出？

默认的日志输出方式虽然简单，但存在以下问题：

• 无法持久化保存日志（程序关闭后日志丢失）
• 不能按模块或级别分类存储
• 不利于生产环境排查问题

通过自定义输出位置，我们可以将日志写入文件、数据库，甚至发送到远程日志服务器，极大提升可维护性。

二、Go语言log包基础回顾

Go 的 log 包提供了三个常用函数：

• log.Print()：普通日志
• log.Printf()：格式化日志
• log.Println()：带换行的日志

默认它们都输出到 os.Stderr。要改变输出目标，我们需要使用 log.SetOutput() 方法。

三、将日志输出到文件（实战示例）

下面是一个完整的例子，展示如何将日志写入本地文件：

package mainimport (	"log"	"os")func main() {	// 打开或创建日志文件	file, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)	if err != nil {		log.Fatalf("无法创建日志文件: %v", err)	}	defer file.Close()	// 设置 log 包的输出目标为文件	log.SetOutput(file)	// 现在所有日志都会写入 app.log	log.Println("这是一条测试日志")	log.Printf("当前时间: %s", "2024-06-01")}

运行上述代码后，你会在项目目录下看到一个名为 app.log 的文件，里面包含你写入的日志内容。

四、同时输出到控制台和文件（多输出流）

有时我们既想在控制台看到日志，又想保存到文件。这时可以使用 io.MultiWriter：

package mainimport (	"io"	"log"	"os")func main() {	file, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)	if err != nil {		log.Fatal(err)	}	defer file.Close()	// 创建一个多写入器：同时写入文件和标准错误	multiWriter := io.MultiWriter(file, os.Stderr)	// 设置 log 输出到多写入器	log.SetOutput(multiWriter)	log.Println("这条日志会同时出现在控制台和文件中！")}

五、创建独立的日志器（避免全局影响）

使用 log.SetOutput() 会影响整个程序的默认日志行为。如果你只想为某个模块创建专用日志器，可以使用 log.New()：

package mainimport (	"log"	"os")func main() {	file, _ := os.OpenFile("module.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)	defer file.Close()	// 创建一个新的日志器，前缀为 [MODULE]，并输出到文件	moduleLogger := log.New(file, "[MODULE] ", log.LstdFlags)	// 使用新日志器	moduleLogger.Println("这是模块专用日志")	// 默认的 log 仍然输出到 stderr	log.Println("这是全局日志，不受影响")}

六、总结与最佳实践

通过本文，你已经掌握了 Go 语言中 log 包的几种自定义输出方式：

• 使用 log.SetOutput() 全局重定向日志
• 结合 io.MultiWriter 实现多目标输出
• 使用 log.New() 创建独立日志器，避免污染全局状态

这些技巧是构建健壮 Go 应用的基础。无论你是初学者还是有经验的开发者，掌握 Go语言日志输出、log包自定义输出、Go日志重定向 和 Go语言日志教程 中的核心概念，都能让你的程序更易调试和维护。

祝你在 Go 语言开发之旅中日志清晰、Bug 少少！