Go 的 json.Unmarshal 将所有 JSON 数字（无论是否含小数点）默认解析为 float64，这是由 JSON 规范本身无整数类型所决定的；本文详解其原理、验证方式及在实际开发中安全提取整数/浮点数的推荐实践。
go 的 `json.unmarshal` 将所有 json 数字（无论是否含小数点）默认解析为 `float64`，这是由 json 规范本身无整数类型所决定的；本文详解其原理、验证方式及在实际开发中安全提取整数/浮点数的推荐实践。
在 Go 中使用 json.Unmarshal 解析 JSON 数组（如 [1, 2.5, "aaa", true, false]）到 []interface{} 时，常会惊讶地发现：看似整数的 1 在反射检查中类型为 float64，而非 int64。这并非 bug，而是 完全符合标准的预期行为。
根本原因在于：JSON 规范中并不存在“整数”这一独立类型。根据 RFC 8259 §6，JSON 数字定义为“一个十进制数字序列，可选包含小数部分和指数部分”，其语义等价于 IEEE 754 双精度浮点数。因此，Go 的 encoding/json 包严格遵循该规范——所有 JSON 数字（包括 1、-42、0）均被无差别解析为 float64，以确保数值精度兼容性和跨语言一致性。
可通过以下精简示例验证该行为：
package main
import (
"encoding/json"
"fmt"
"reflect"
)
func main() {
data := `[1, 2.0, 3.14, -42]`
var arr []interface{}
json.Unmarshal([]byte(data), &arr)
for i, v := range arr {
t := reflect.TypeOf(v).Kind()
fmt.Printf("Index %d: value=%v, kind=%s\n", i, v, t)
}
}
// 输出：
// Index 0: value=1, kind=float64
// Index 1: value=2, kind=float64
// Index 2: value=3.14, kind=float64
// Index 3: value=-42, kind=float64⚠️ 重要注意事项：
- 直接对 float64 值调用 reflect.Value.Int() 会 panic（因底层非整数类型），必须先判断是否为整数值；
- 使用 math.IsInf 或 math.IsNaN 检查特殊浮点值（虽 JSON 不允许 NaN/Infinity，但解析异常时可能产生）；
- 若需区分整数与浮点数语义，应在业务层做逻辑判断（例如：f == float64(int64(f))），而非依赖反射类型。
✅ 安全提取整数/浮点数的推荐方式：
import "math"
func safeToInt64(f float64) (int64, bool) {
if !math.IsFinite(f) {
return 0, false
}
if f == float64(int64(f)) { // 确保无精度丢失
return int64(f), true
}
return 0, false
}
func processJSONNumber(v interface{}) {
if f, ok := v.(float64); ok {
if i, isInt := safeToInt64(f); isInt {
fmt.Printf("Parsed as integer: %d\n", i)
} else {
fmt.Printf("Parsed as float: %g\n", f)
}
}
}总结：Go 的 JSON 解析器将数字统一映射为 float64 是对 JSON 标准的忠实实现。开发者应摒弃“JSON 整数 → Go 整数”的直觉假设，转而采用显式类型判断与安全转换逻辑。在构建通用 JSON 处理工具（如 API 网关、配置解析器）时，此认知尤为关键——它直接影响类型推导准确性、序列化保真度及错误处理鲁棒性。
