log

type Level int

type LogType string

type Logger interface {
	// SetLevel 设置日志级别。
	// 只有大于或等于设置级别的日志才会被记录。
	SetLevel(level Level)

	// GetLevel 获取当前的日志级别。
	GetLevel() Level

	// Debug 记录调试级别的日志。
	// 参数 args 支持任意类型的值，这些值会被转换为字符串并连接。
	// 调试日志应该包含有助于诊断问题的详细信息。
	Debug(args ...interface{})

	// Debugf 记录格式化的调试级别日志。
	// 参数 format 是格式化字符串，args 是对应的参数。
	// 支持标准的 Printf 风格的格式化。
	Debugf(format string, args ...interface{})

	// Info 记录信息级别的日志。
	// 参数 args 支持任意类型的值，这些值会被转换为字符串并连接。
	// 信息日志应该记录系统的正常运行状态。
	Info(args ...interface{})

	// Infof 记录格式化的信息级别日志。
	// 参数 format 是格式化字符串，args 是对应的参数。
	// 支持标准的 Printf 风格的格式化。
	Infof(format string, args ...interface{})

	// Warn 记录警告级别的日志。
	// 参数 args 支持任意类型的值，这些值会被转换为字符串并连接。
	// 警告日志应该包含可能导致问题的情况。
	Warn(args ...interface{})

	// Warnf 记录格式化的警告级别日志。
	// 参数 format 是格式化字符串，args 是对应的参数。
	// 支持标准的 Printf 风格的格式化。
	Warnf(format string, args ...interface{})

	// Error 记录错误级别的日志。
	// 参数 args 支持任意类型的值，这些值会被转换为字符串并连接。
	// 错误日志应该包含错误的详细信息和上下文。
	Error(args ...interface{})

	// Errorf 记录格式化的错误级别日志。
	// 参数 format 是格式化字符串，args 是对应的参数。
	// 支持标准的 Printf 风格的格式化。
	Errorf(format string, args ...interface{})

	// Fatal 记录致命错误级别的日志。
	// 参数 args 支持任意类型的值，这些值会被转换为字符串并连接。
	// 记录日志后会导致程序以状态码 1 退出。
	// 这个方法应该只在程序无法继续运行时使用。
	Fatal(args ...interface{})

	// Fatalf 记录格式化的致命错误级别日志。
	// 参数 format 是格式化字符串，args 是对应的参数。
	// 支持标准的 Printf 风格的格式化。
	// 记录日志后会导致程序以状态码 1 退出。
	Fatalf(format string, args ...interface{})

	// WithField 添加一个字段到日志上下文。
	// 参数 key 是字段名，value 是字段值。
	// 返回一个新的 Logger 实例，原实例不会被修改。
	// 这个方法用于添加结构化的上下文信息到日志中。
	WithField(key string, value interface{}) Logger

	// WithFields 添加多个字段到日志上下文。
	// 参数 fields 是要添加的字段映射。
	// 返回一个新的 Logger 实例，原实例不会被修改。
	// 这个方法用于一次性添加多个结构化字段。
	WithFields(fields map[string]interface{}) Logger
}

type LogrusLogger struct {
	// contains filtered or unexported fields
}

type StdLogger struct {
	// contains filtered or unexported fields
}