浮点格式化

Go 里把浮点数转成字符串时，真正容易混淆的不是函数名，而是第四个参数 bitSize 和第三个参数 prec。如果字符串还要再交给 strconv.ParseFloat，最小可用写法通常是 strconv.FormatFloat(v, 'g', -1, 64)：-1 不是“保留 1 位小数”，而是让 Go 选择能够精确还原原浮点值的最少数字。

先把 prec=-1 和“保留小数位”分开

很多“浮点格式化不准确”的问题，起点是把 prec 当成了统一的小数位参数。这个理解只对 e、E、f、x 和 X 等格式成立；对 g 和 G，它表示最多保留多少位有效数字。更特殊的是 -1：标准库会选择让 ParseFloat 精确得到原值所需的最少数字。

因此，序列化配置值、缓存浮点字段或在文本协议中临时传递浮点数时，先看目标是“还原同一个浮点值”还是“给人看起来整齐”。前者用 -1，后者再考虑固定小数位。

package main

import (
	"fmt"
	"strconv"
)

func main() {
	value := 0.1 + 0.2

	// -1 表示由标准库选择能精确往返的最短表示。
	text := strconv.FormatFloat(value, 'g', -1, 64)
	parsed, err := strconv.ParseFloat(text, 64)
	if err != nil {
		// 解析失败时不要把零值当成成功结果继续写入。
		panic(err)
	}

	fmt.Printf("文本=%s，还原值=%v，相等=%v\\n", text, parsed, parsed == value)
}

这里关注的是“解析后是否回到同一个 float64 值”，不是字符串是否固定长度。字符串可能使用普通小数，也可能使用指数形式；只要解析语义对应，表示就是有效的。

最小配方：g、-1、64 各自负责什么

把调用拆开看，会更容易排错：g 决定总体采用紧凑的通用格式，-1 决定精度策略，64 告诉函数原值按 64 位浮点数处理。三者不是一个开关的不同写法。

如果变量本来就是 float64，使用 64 是自然选择；如果变量来自 float32，不要因为函数参数是 float64 就机械地传 64，应该让格式化和之后的解析都按 32 位精度理解它。

bitSize 要和实际浮点类型对应

FormatFloat 的输入类型是 float64，但 bitSize 用来表达原始浮点值的位宽。Go 会根据这个参数决定舍入和需要输出的有效数字数量；这就是为什么同一个数值表达式，在 32 和 64 下可能得到不同长度的字符串。

package main

import (
	"fmt"
	"strconv"
)

func main() {
	value32 := float32(3.1415926535)
	value64 := float64(value32)

	// value32 的有效值已经是 32 位，格式化时保留这个位宽语义。
	text32 := strconv.FormatFloat(float64(value32), 'g', -1, 32)
	// value64 按 64 位处理，允许输出更多能区分相邻值的数字。
	text64 := strconv.FormatFloat(value64, 'g', -1, 64)

	fmt.Println(text32)
	fmt.Println(text64)
}

配套解析时也要使用相同位宽：写出 bitSize=32 的文本，就用 strconv.ParseFloat(text, 32)；写出 64 位文本，就用 64。否则读回过程可能得到另一个邻近浮点值，问题不一定立刻表现为明显报错。

展示用 f，存储用 g：不要混用两个目标

如果需求是金额、百分比或报表列的固定外观，f 加明确的正数精度更合适，例如 FormatFloat(v, 'f', 2, 64)。但这会按两位小数舍入，得到的是展示字符串，不应再被当成原始值的无损备份。

如果需求是配置文件、日志字段或文本协议中的可逆传输，g 与 -1 更接近目标。可以把两类调用分开命名，避免后续维护者误把展示结果写回数据存储。

package main

import "strconv"

func formatForDisplay(value float64) string {
	// 固定两位只服务界面或报表，不承诺还原原始浮点值。
	return strconv.FormatFloat(value, 'f', 2, 64)
}

func formatForRoundTrip(value float64) string {
	// g 配合 -1 让文本尽量短，同时保留 ParseFloat 的精确还原能力。
	return strconv.FormatFloat(value, 'g', -1, 64)
}

常见问题

为什么不用 f、prec=-1 直接解决所有场景？

f 的 -1 表示去掉无意义的尾随零，但它仍然坚持普通小数形式；极大或极小的值可能出现很长的字符串。需要紧凑、可逆的文本时，通常选择 g。

ParseFloat 返回的总是 float64，为什么还要传 32？

返回变量类型虽然是 float64，但传入 32 会按 float32 的精度解析，随后转换为 float32 不会再改变其值。这是控制语义位宽，不是改变 Go 函数的静态返回类型。

浮点数适合直接保存金额吗？

本文只讨论浮点值的文本往返，不改变浮点运算本身的误差特性。金额需要精确十进制语义时，应根据业务规则选择整数最小单位或专门的十进制定点方案。

记住一个判断就够了：面向人看的字符串先决定外观，面向程序还原的字符串先决定位宽，再用 g 和 -1 保留可逆性。