Go 的 json.Unmarshal 将所有 JSON 数字（无论整数或浮点数）默认解析为 float64，这是由 JSON 规范和 Go 标准库设计共同决定的；本文详解其原理，并提供类型安全的判别与转换实践方案。
go 的 `json.unmarshal` 将所有 json 数字（无论整数或浮点数）默认解析为 `float64`，这是由 json 规范和 go 标准库设计共同决定的；本文详解其原理，并提供类型安全的判别与转换实践方案。
在 Go 中处理动态 JSON 数据（如 []interface{}）时，开发者常惊讶于：明明 JSON 中写的是 "1" 或 [1, 2, 3] 这样的整数，反序列化后却得到 float64 类型值——例如 1.0 而非 int64。这并非 bug，而是 完全符合预期的、有明确文档依据的行为。
? 为什么 JSON 数字总是变成 float64？
根据 Go 官方文档对 json.Unmarshal 的说明：
To unmarshal JSON into an interface value, Unmarshal stores one of these in the interface value:
- bool, for JSON booleans
- float64, for JSON numbers
- string, for JSON strings
- []interface{}, for JSON arrays
- map[string]interface{}, for JSON objects
- nil, for JSON null
根本原因在于：JSON 规范本身不区分整数与浮点数。RFC 8259 明确定义 JSON Number 为“一个带可选小数部分和指数部分的十进制数字”，语义上等价于 IEEE 754 双精度浮点数。因此，Go 的 encoding/json 包选择统一使用 float64 表示所有 JSON 数字，既保证精度兼容性（能无损表示典型 53 位整数），又避免解析时做额外类型猜测（如判断 123 应该是 int 还是 int64），从而保持行为确定、高效且无歧义。
立即学习“go语言免费学习笔记（深入）”；
✅ 正确识别并还原整数值的实践方法
虽然底层是 float64，但我们可通过数学判断安全地区分“整数形式的数字”与“真浮点数”：
package main
import (
"encoding/json"
"fmt"
"math"
"reflect"
)
var args = `[1, 2.5, "aaa", true, false, 1000000000000000000]`
func main() {
var x []interface{}
if err := json.Unmarshal([]byte(args), &x); err != nil {
panic(err)
}
for i, arg := range x {
v := reflect.ValueOf(arg)
switch v.Kind() {
case reflect.Float64:
f := v.Float()
// 判断是否为整数（注意：仅适用于可精确表示的整数范围）
if f == math.Trunc(f) && f >= math.MinInt64 && f <= math.MaxInt64 {
fmt.Printf("[%d] int64 %d\n", i, int64(f))
} else {
fmt.Printf("[%d] float64 %.1f\n", i, f)
}
case reflect.String:
fmt.Printf("[%d] string %q\n", i, v.String())
case reflect.Bool:
fmt.Printf("[%d] bool %t\n", i, v.Bool())
default:
fmt.Printf("[%d] other %v (type: %s)\n", i, arg, v.Kind())
}
}
}输出：
[0] int64 1 [1] float64 2.5 [2] string "aaa" [3] bool true [4] bool false [5] int64 1000000000000000000
⚠️ 注意事项与最佳实践
- 精度边界：float64 可精确表示 ≤ 2⁵³ 的整数（约 ±9×10¹⁵）。超出此范围（如大 ID、时间戳纳秒值）可能丢失精度，此时应考虑自定义 json.Unmarshaler 或使用 json.RawMessage 延迟解析。
- 不要强制类型断言：避免 arg.(int64) —— 因为它必然 panic，正确做法永远是先 arg.(float64) 再逻辑转换。
- 结构体优先于 interface{}：若数据模式固定，应定义具体 struct 并使用字段标签（如 json:"id,string" 处理字符串化数字），兼顾类型安全与性能。
- 第三方库可选：如需更精细控制（如保留原始 JSON 类型信息），可评估 gjson（只读）或 jsoniter（兼容增强版 encoding/json）。
总之，理解 float64 是 JSON 数字的“唯一原生表示”是 Go JSON 处理的基石。掌握其原理与安全转换模式，能让你写出更鲁棒、可维护的动态 JSON 解析逻辑。
