在 Go 语言库中实现规范的日志记录，可以帮助开发者更好地理解库的运行状态，方便调试和问题排查。一种常用的方法是创建一个全局 logger 变量，并在 init 函数中进行初始化。这样可以在库的任何地方使用同一个 logger 实例，并集中进行配置。
创建 logger 文件
首先，创建一个名为 logger.go 的文件，用于声明和初始化 logger 变量。
package your_package_name
import (
"log"
"os"
)
var logger *log.Logger
func init() {
logger = log.New(os.Stderr, "your_package_name: ", log.Ldate|log.Ltime|log.Lshortfile)
}代码解释：
- package your_package_name: 指定包名，替换为你自己的包名。
- import ("log", "os"): 导入 log 和 os 包。log 包提供了日志记录的功能，os 包提供了与操作系统交互的功能。
- var logger *log.Logger: 声明一个全局 logger 变量，类型为 *log.Logger。
- func init() {}: init 函数在包被导入时自动执行，用于初始化 logger 变量。
- logger = log.New(os.Stderr, "your_package_name: ", log.Ldate|log.Ltime|log.Lshortfile): 创建一个新的 logger 实例。
- os.Stderr: 指定日志输出到标准错误流。你也可以选择 os.Stdout 输出到标准输出流，或者输出到文件。
- "your_package_name: ": 指定日志前缀，方便区分不同库的日志。
- log.Ldate|log.Ltime|log.Lshortfile: 指定日志格式。
- log.Ldate: 包含日期。
- log.Ltime: 包含时间。
- log.Lshortfile: 包含文件名和行号，方便定位日志的来源。
在其他文件中使用 logger
现在，可以在库的其他文件中使用 logger 变量进行日志记录。
package your_package_name
func someFunction() {
logger.Println("This is a log message from someFunction.")
logger.Printf("This is a formatted log message with value: %d", 123)
}使用 Go 内置 log 包
如果只需要一个全局 logger 实例，也可以直接使用 Go 内置的 log 包进行配置。
package your_package_name
import (
"log"
"os"
)
func init() {
log.SetOutput(os.Stderr)
log.SetPrefix("your_package_name: ")
log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)
}
func someFunction() {
log.Println("This is a log message from someFunction.")
log.Printf("This is a formatted log message with value: %d", 123)
}代码解释：
- log.SetOutput(os.Stderr): 设置日志输出目标。
- log.SetPrefix("your_package_name: "): 设置日志前缀。
- log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile): 设置日志格式。
注意事项：
- 并发安全： log.Logger 是并发安全的，可以在多个 goroutine 中同时使用。
- 日志级别： log 包本身没有提供日志级别的概念。如果需要支持不同的日志级别（例如 Debug, Info, Warning, Error），可以考虑使用第三方日志库，例如 logrus 或 zap。
- 错误处理： 在关键代码路径中，应该检查错误并记录错误信息。
总结：
通过创建全局 logger 变量并在 init 函数中初始化，可以在 Go 语言库中实现规范化的日志记录。 这种方法可以集中配置和管理日志，方便调试和问题排查。 如果只需要一个全局 logger 实例，也可以直接使用 Go 内置的 log 包进行配置。选择哪种方法取决于具体的需求和项目的复杂程度。
