Go strconv.FormatBool 怎样输出稳定的布尔文本

在日志、键值文本或简单配置导出中，布尔值经常要从 Go 的 bool 变成字符串。这个场景直接使用 strconv.FormatBool 即可：传入 true 得到 "true"，传入 false 得到 "false"，返回类型是 string，不需要自己写分支。

官方文档：https://pkg.go.dev/strconv#FormatBool

这篇只解决“布尔值怎样稳定输出为文本”。如果目标是 JSON 文档、URL 参数或某个业务协议，仍然要使用对应的序列化组件；FormatBool 只是一个清晰、确定的布尔文本转换函数。

FormatBool 的返回值很简单，但契约要记牢

FormatBool(b bool) string 只有一个参数，也没有格式字符、精度或位宽选项。它根据布尔值返回小写的 true 或 false，因此很适合拼接日志字段、写入键值文本或生成内部状态标签。

需要注意的是，结果是字符串而不是布尔值。后续如果还要参与逻辑判断，应保留原始 bool；只有在跨文本边界时才转换，避免把字符串 "false" 误当成布尔值使用。

最小写法：把 bool 转成稳定文本

下面的例子把开关状态写进一行键值文本。代码中保留原始布尔变量，同时只在输出边界调用 FormatBool。

package main

import (
    "fmt"
    "strconv"
)

func main() {
    enabled := true

    // 只在文本输出边界转换，业务判断仍然使用 bool。
    state := strconv.FormatBool(enabled)
    line := "enabled=" + state

    fmt.Println(line)
}

这段代码的输出是：

enabled=true

把 enabled 改成 false 后，输出会对应变成 enabled=false。转换没有额外的格式参数，也不会输出大写的 TRUE 或 FALSE。

为什么不直接用 fmt.Sprintf

fmt.Sprintf 当然也能格式化布尔值，但它更适合一个字符串里同时放入多种值。单独处理布尔字段时，FormatBool 的意图更明确，调用者不需要记住占位符，也不会把格式化逻辑和文本拼接混在一起。

package main

import (
    "fmt"
    "strconv"
)

func main() {
    ready := false

    // 单字段转换使用专用 API，避免把布尔文本规则藏在格式串里。
    direct := strconv.FormatBool(ready)
    formatted := fmt.Sprintf("%t", ready)

    fmt.Println(direct == formatted)
    fmt.Println(direct)
}

两种写法在这个简单例子里会得到相同文本，但含义不同：FormatBool 表达“把布尔值转换成文本”，Sprintf 表达“按照一个更大的格式串组织输出”。如果只是转换，优先选前者；如果一行中还要放入数字、时间和多个字段，再考虑统一格式化。

需要从文本还原时，换成 ParseBool

FormatBool 负责正向转换，反向读取应使用 strconv.ParseBool。官方文档列出的可接受文本包括 1、t、TRUE、true、True 以及对应的 false 形式；其他文本会返回错误。

package main

import (
    "fmt"
    "strconv"
)

func main() {
    raw := "false"

    // 解析必须检查 error，非法输入不能悄悄当成 false。
    value, err := strconv.ParseBool(raw)
    if err != nil {
        fmt.Println("invalid bool:", err)
        return
    }

    fmt.Println(value)
}

工程上最容易犯的错误是忽略 error，把解析失败的结果当作合法的 false。如果文本来自用户输入、环境变量或文件，应该保留错误分支；如果文本由同一套程序刚刚通过 FormatBool 生成，格式通常更可控，但仍不代表可以省略错误处理。

文本输出、JSON 和自定义协议不要混为一谈

可以用下面这张速查表做选择：

不要因为 FormatBool 输出了 true/false，就把它当成所有协议的通用编码器。协议是否要求引号、转义、字段顺序或额外包装，应由协议自己的库决定。

常见问题

FormatBool 会返回大写的 TRUE 吗？

不会。它按布尔值返回小写的 true 或 false。如果业务协议要求其他大小写，应在明确的协议适配层处理。

FormatBool 能直接把字符串转成 bool 吗？

不能。字符串转布尔值使用 strconv.ParseBool，并检查它返回的错误。

JSON 字段可以直接拼接 FormatBool 的结果吗？

不建议手工拼接完整 JSON。字段较多或存在转义时，使用 encoding/json 让 JSON 编码器负责结构和转义；FormatBool 更适合简单文本边界。

小结

strconv.FormatBool 解决的是一个很具体的问题：把 bool 明确地变成小写 true 或 false 字符串。单字段转换优先使用它；需要还原就使用 ParseBool 并处理错误；涉及 JSON 或其他协议时，把编码职责交给对应组件。这样既保持了输出稳定，也避免让一个小函数承担超出边界的工作。