Go slog.Level.String 怎样把日志级别转换为文本

slog.Level.String() 的用法很直接：它把日志级别转换成稳定的可读文本。内置级别会得到 DEBUG、INFO、WARN、ERROR；落在两个命名级别之间的数值，会得到类似 INFO+2 或 ERROR-1 的结果。这个规则既保留了级别相对位置，也避免把自定义数值误写成没有含义的整数。

这篇只讨论文本表示和展示边界，不把 LevelVar 的动态调整、Handler 的过滤策略混进来。下面的代码使用 Go 标准库 log/slog，示例是静态说明，重点在输入值、输出文本和外部配置之间的关系。

先把四个命名级别和数值区间分开

slog.Level 本质上是整数类型，官方定义的常用值是 LevelDebug=-4、LevelInfo=0、LevelWarn=4、LevelError=8。String 不会简单地把整数转成十进制字符串，而是选择最近的基础名称，再追加相对偏移。

package main

import (
	"fmt"
	"log/slog"
)

func main() {
	levels := []slog.Level{
		slog.LevelDebug,
		slog.LevelInfo,
		slog.LevelWarn,
		slog.LevelError,
		slog.LevelInfo + 2,
		slog.LevelError - 1,
	}

	for _, level := range levels {
		// String 保留命名级别和数值偏移，便于日志和配置审计。
		fmt.Printf("%d => %s\n", level, level.String())
	}
}

输出关系可以概括为：命名值直接返回大写名称；例如 LevelInfo+2 返回 INFO+2，LevelError-1 返回 ERROR-1。因此展示层应该保留这个文本，不要再用 strconv.Itoa(int(level)) 覆盖它。

自定义级别要保留偏移，不要伪造新名称

业务系统经常需要在 INFO 与 WARN 之间放一个通知级别，或者在 ERROR 上方表达更严重的事件。String 会把它们表示为 INFO+2、ERROR+4 这样的形式。这个结果的优点是可读、可排序，也能从文本看出它靠近哪个标准级别。

不要把 INFO+2 当成一个可以任意注册的名称。它仍然是一个数值级别的格式化结果；如果系统需要给它显示“NOTICE”，应在展示层单独维护映射，同时保留原始 slog.Level，避免下游丢失精确值。

package main

import (
	"fmt"
	"log/slog"
)

func describe(level slog.Level) string {
	// 先保留标准 String 结果，业务别名只作为外层展示信息。
	text := level.String()
	if level == slog.LevelInfo+2 {
		return "NOTICE (" + text + ")"
	}
	return text
}

func main() {
	// 自定义数值仍然落在 slog 的整数级别空间内。
	fmt.Println(describe(slog.LevelInfo + 2))
}

安全边界在这里很重要：外部请求、配置文件或命令行参数不应直接决定日志系统的权限动作。先把输入解析成允许的级别集合，再把原始数字和 String() 结果写入审计字段，便于发现配置漂移。

JSON 和文本配置可以复用同一套表示

slog.Level 的 JSON 编码会使用 String() 的结果并加上 JSON 字符串引号；文本编码也会复用同一内容。这样，日志里的级别、配置快照里的级别和诊断接口里的级别不会各自发明一套写法。

package main

import (
	"encoding/json"
	"fmt"
	"log/slog"
)

func main() {
	level := slog.LevelWarn + 2

	data, err := json.Marshal(level)
	if err != nil {
		// 编码失败时保留错误，不把空字符串当成合法级别。
		panic(err)
	}

	text, err := level.MarshalText()
	if err != nil {
		// 文本配置写入失败时应中止提交，避免落盘半条配置。
		panic(err)
	}

	fmt.Printf("json=%s text=%s\n", data, text)
}

反过来读取配置时，使用 UnmarshalText 或 UnmarshalJSON，不要把任意字符串直接转换为整数。官方解析逻辑会识别 DEBUG、INFO、WARN、ERROR 以及数值偏移；未知名称应被视为配置错误，而不是静默降级到 INFO。

把日志级别转换放在可审计的边界上

在生产代码里，转换函数最好只负责表示，不负责修改 Logger、Handler 或全局状态。调用方可以把原始数值保存在结构化字段中，把 String() 结果用于人读的消息或配置回显，再由专门的策略决定是否接受这个级别。

可以按下面的清单收口：

• 固定展示：调用 level.String()，不要自行拼接名称。
• 自定义数值：保留 INFO+2 这类偏移文本，同时保存原始整数。
• 外部输入：用 UnmarshalText 或 UnmarshalJSON 解析，并处理错误。
• 审计记录：同时记录来源、原始文本、解析后的数值和最终展示文本。

这样做能把“显示什么”和“允许什么”分开：String() 解决可读表示，输入策略解决风险控制，Handler 过滤解决是否输出，三者职责不会互相替代。

常见问题

Level.String() 会返回小写吗？

不会。内置名称和偏移基准使用大写形式，例如 WARN、INFO+2。如果界面需要小写，应在界面层转换，不要改变日志和配置的标准表示。

为什么不直接输出整数？

整数能用于比较，却不适合诊断和审计。ERROR-1 既保留了数值信息，又让读者知道它位于错误级别附近；这正是 String() 的价值。

总的来说，slog.Level.String() 适合做稳定的展示边界：标准级别输出名称，区间级别输出名称加偏移，JSON 和文本编码沿用同一规则。只要把输入解析、策略判断和日志输出分层，日志级别的可读性与审计性就能同时保住。