Go strconv.AppendFloat 怎样控制格式化精度

我在把浮点值拼进日志字段或协议缓冲区时，最容易先写错的不是函数名，而是 prec 和 bitSize 的职责。strconv.AppendFloat 的判断可以先记成一句话：format 决定文本形状，prec 决定保留规则，bitSize 决定按哪种浮点精度理解原值；调用结果要接回返回的切片。

官方地址：https://pkg.go.dev/strconv#AppendFloat

AppendFloat 的返回值先接住

AppendFloat(dst, f, fmt, prec, bitSize) 会把浮点数追加到 dst，返回扩展后的 []byte。它和 FormatFloat 的格式规则一致，差别在于前者直接面向已有缓冲区，适合把多个字段连续写入。

package main

import (
    "fmt"
    "strconv"
)

func main() {
    buf := []byte("price=")
    // AppendFloat 返回的新切片可能已经换了底层数组，不能忽略返回值。
    buf = strconv.AppendFloat(buf, 12.3456, 'f', 2, 64)
    fmt.Println(string(buf)) // price=12.35
}

这里的 dst 可以有前缀，也可以有后续字段。忽略返回值时，即使底层数组暂时没有扩容，代码的意图也不完整；一旦需要扩容，后续读取的还是旧切片长度。

format 决定输出是定点还是指数形状

常用格式可以按输出协议来选：'f' 生成不带指数的定点形式；'e' 和 'E' 使用十进制指数；'g' 和 'G' 在定点与指数形式之间选择；'x' 和 'X' 用十六进制小数与二进制指数表示。'b' 是二进制指数形式，通常用于需要精确表达浮点内部表示的场景。

不要把 format 当作“精度开关”。例如金额展示通常先考虑 'f'，科学计数或范围很大的指标可以考虑 'e'/'E'，而通用日志常用 'g' 保留有效数字并避免无意义的尾随零。

prec 在不同 format 下含义不同

prec 的含义跟着 format 变化，这是“看起来精度不对”的主要来源：

package main

import (
    "fmt"
    "strconv"
)

func main() {
    v := 3.1415926535
    // f 的 2 表示两位小数，g 的 4 表示最多四位有效数字。
    fixed := strconv.AppendFloat(nil, v, 'f', 2, 64)
    compact := strconv.AppendFloat(nil, v, 'g', 4, 64)
    exact := strconv.AppendFloat(nil, v, 'g', -1, 64)
    fmt.Println(string(fixed), string(compact), string(exact))
}

如果需求是“固定两位小数”，用 'f', 2 直接表达；如果需求是“最多四位有效数字”，应使用 'g', 4，不要误写成 'f', 4。

bitSize 决定按 float32 还是 float64 格式化

AppendFloat 的参数类型是 float64，但 bitSize 仍然要和原始数据的语义一致：原值来自 float32 时传 32，来自 float64 时传 64。官方示例中，同一个数分别按 32 位和 64 位格式化，输出的有效数字数量就不同。

package main

import (
    "fmt"
    "strconv"
)

func main() {
    v := 3.1415926535
    // 先转成 float32 再转回 float64，保留原始 float32 的数值语义。
    v32 := float32(v)
    text32 := strconv.AppendFloat(nil, float64(v32), 'g', -1, 32)
    text64 := strconv.AppendFloat(nil, v, 'g', -1, 64)
    fmt.Printf("float32=%s float64=%s\n", text32, text64)
}

bitSize 不是随便填的显示宽度。把一个本来按 float32 采集的值用 64 输出，可能会让读者误以为这些尾数来自更高精度的原始数据；反过来用 32 表示 float64，则会主动缩短可表达的信息。

放进日志和协议字段时怎样组合参数

工程上我会把“文本约定”写在调用点旁边，而不是只传一组神秘数字。金额展示、可逆序列化、监控指标可以使用不同组合，关键是让调用者知道选择了固定小数、有效数字还是最短可逆表示。

func appendMetric(dst []byte, name string, value float64) []byte {
    // 先追加字段名和分隔符，再用 g/-1 追加最短可逆的浮点文本。
    dst = append(dst, name...)
    dst = append(dst, '=')
    dst = strconv.AppendFloat(dst, value, 'g', -1, 64)
    return dst
}

如果输出是固定金额，替换为 'f', 2, 64；如果输出来自 float32 采样，使用 bitSize=32。代码块中的注释说明了参数意图，后续维护者不必重新猜测“为什么是 -1”。

常见问题

为什么 prec=2 没有得到两位有效数字？

当 format='f'、'e' 或 'E' 时，2 表示小数点后的两位；只有 'g'/'G' 才把 2 当作有效数字上限。

AppendFloat 和 FormatFloat 的格式规则不一样吗？

不一样的是输出目标：FormatFloat 返回字符串，AppendFloat 追加到 []byte；两者使用同一套 format、prec 和 bitSize 语义。

什么时候应该传 prec=-1？

需要尽量短、并希望后续 ParseFloat 恢复原值时可以用 -1。如果协议明确要求固定小数位或固定有效数字，就传明确的非负精度。