Go语言中JSON数字类型处理详解（如何避免浮点数精度丢失问题）

为什么会出现精度问题？

在 Go 语言的标准库 encoding/json 中，默认会将 JSON 中的数字解析为 float64 类型。这是因为 JSON 规范本身没有区分整数和浮点数，所有数字都被视为“数值”。

然而，float64 是基于 IEEE 754 标准的双精度浮点数，它无法精确表示某些十进制小数（例如 0.1），也无法安全表示超过 2^53 的整数。这就可能导致 数字精度丢失。

示例：默认解析的问题

看下面这段代码：

package mainimport (    "encoding/json"    "fmt")type Data struct {    Value float64 `json:"value"`}func main() {    jsonData := `{"value": 9007199254740993}` // 超过 2^53    var d Data    json.Unmarshal([]byte(jsonData), &d)    fmt.Println(d.Value) // 输出：9.007199254740992e+15（精度已丢失！）}

你会发现，原本的整数 9007199254740993 被错误地解析成了 9007199254740992，这就是 float64 精度限制 导致的问题。

解决方案一：使用 string 类型 + strconv

如果你知道某个字段是大整数或需要高精度的小数，可以先将其作为字符串解析，再用 strconv 包转换：

type Data struct {    Value string `json:"value"`}func main() {    jsonData := `{"value": "9007199254740993"}`    var d Data    json.Unmarshal([]byte(jsonData), &d)        // 转为 int64（如果确定在范围内）    num, err := strconv.ParseInt(d.Value, 10, 64)    if err != nil {        panic(err)    }    fmt.Println(num) // 正确输出：9007199254740993}

解决方案二：使用 json.Number（推荐）

Go 提供了 json.Number 类型，它能以字符串形式保留原始 JSON 数字，避免自动转为 float64。使用前需启用 UseNumber()：

package mainimport (    "encoding/json"    "fmt")type Data struct {    Value json.Number `json:"value"`}func main() {    jsonData := `{"value": 9007199254740993}`        decoder := json.NewDecoder(strings.NewReader(jsonData))    decoder.UseNumber() // 关键！启用 Number 模式        var d Data    decoder.Decode(&d)        // 可转为 string、int64 或 float64    str := d.Value.String()    i64, _ := d.Value.Int64()    f64, _ := d.Value.Float64()        fmt.Println("String:", str)   // "9007199254740993"    fmt.Println("Int64:", i64)     // 9007199254740993    fmt.Println("Float64:", f64)   // 9.007199254740993e+15}

解决方案三：自定义 UnmarshalJSON 方法

对于更复杂的场景（如金融计算），你可能需要使用 big.Float 或 decimal 库。这时可以通过实现 UnmarshalJSON 接口来自定义解析逻辑：

import "github.com/shopspring/decimal"type Price struct {    Amount decimal.Decimal `json:"amount"`}// 如果 decimal.Decimal 已实现 UnmarshalJSON，则无需额外代码// 否则需手动实现func (p *Price) UnmarshalJSON(data []byte) error {    var raw struct {        Amount string `json:"amount"`    }    if err := json.Unmarshal(data, &raw); err != nil {        return err    }    d, err := decimal.NewFromString(raw.Amount)    if err != nil {        return err    }    p.Amount = d    return nil}

总结

在 Go语言 JSON处理 中，数字精度问题是一个常见但容易被忽视的陷阱。记住以下几点：

• 默认使用 float64 解析 JSON 数字，可能导致 精度丢失；
• 对大整数或高精度小数，优先考虑 json.Number；
• 金融等敏感场景建议使用 decimal 库；
• 始终根据业务需求选择合适的数据类型。

掌握这些技巧后，你就能在 Go 项目中安全、准确地处理各种 JSON 数字类型了！

关键词：Go语言、JSON处理、数字精度、float64