如何在 Go 中使用 json.Number 处理数字精度问题-Golang-PHP中文网

json.number 是 go 标准库中底层为 string 的类型别名，用于原样保存 json 数字字面量，解决 float64 解析导致的整数精度丢失问题（如金融 id、大整数），需显式调用 int64()/float64() 转换且注意错误处理。

如何在 go 中使用 json.number 处理数字精度问题

json.Number 是什么，它能解决什么问题

json.Number 是 Go 标准库 encoding/json 中的一个类型别名，底层是 string。它不参与数值计算，只负责“原样存下 JSON 里的数字字面量”。当你需要避免 float64 解析导致的精度丢失（比如处理 17 位以上整数、金融 ID、时间戳），或者想延迟决定用 int64 还是 float64 解析时，json.Number 就是那个中间缓冲层。

常见错误现象：json.Unmarshal 直接解析到 float64 字段，结果 9223372036854775807（int64 最大值）变成 9223372036854776000 —— 因为 float64 有效整数位只有约 15–16 位。

它不是万能的：不能直接做算术，不能当 int 或 float64 用，必须显式转换；也不影响序列化行为（json.Marshal 对 json.Number 仍输出数字，不是字符串）。

如何在 struct 中正确使用 json.Number

把字段声明为 json.Number 类型，并确保 JSON tag 存在（哪怕为空）。Go 会自动用字符串方式读取数字，跳过 float64 解析环节。

type Order struct {
    ID       json.Number `json:"id"`
    Amount   json.Number `json:"amount"`
    Metadata map[string]any `json:"metadata"`
}

注意点：

json.Number 字段不能是 nil 指针，必须是值类型（*json.Number 会导致解析失败或空字符串）
如果字段可能缺失，用 json.RawMessage 或自定义 UnmarshalJSON 更稳妥，json.Number 对 null 值会解析成空字符串 ""，后续 Int64() 会报错
不要混用：同一个 struct 里既有 int64 又有 json.Number 字段去接收同一类数字，容易误用未转换的字段

怎么安全地转成 int64 / float64

json.Number 提供 Int64() 和 Float64() 方法，但它们都可能 panic。实际使用必须检查错误：

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

n := json.Number("12345678901234567890")
if i, err := n.Int64(); err == nil {
    // 安全使用 i
} else {
    // 处理溢出或非整数，比如尝试 Float64() 或记录日志
}
<p>f, _ := n.Float64() // 注意：Float64() 不会 panic，但可能丢失精度</p>

关键细节：

Int64() 要求字符串严格是十进制整数（不能带小数点、指数、前导 +），否则返回 error
Float64() 支持科学计数法和小数，但一旦数字超过 2⁵³ 就无法精确表示整数
不要用 strconv.ParseInt(n.String(), 10, 64) 替代 n.Int64()，因为 n.String() 可能含空格或非法字符（虽然标准库一般不会，但不保证）