Go语言JSON解码时如何用json.Number处理字符串编码的数值映射

在Go语言的JSON解码场景中，经常会遇到JSON数据里的数值被编码为字符串类型的情况，比如接口返回的{"id": "123", "score": "95.5"}，此时如果用默认的float64或者int类型去解码，就会直接报错。json.Number作为json包提供的数值类型，恰好可以解决这类字符串编码数值的映射问题，它不会在解码时自动转换数值类型，而是保留原始字符串内容，后续再根据需求做类型转换。

json.Number的基本特性

json.Number本质是string类型的别名，它实现了json.Marshaler和json.Unmarshaler接口，在JSON解码时会直接读取数值的原始字符串表示，不会像默认解码那样把数值转成float64。它提供了几个常用的方法来处理数值转换：

• Int64()：将数值转换为int64类型，转换失败返回错误
• Float64()：将数值转换为float64类型，转换失败返回错误
• String()：返回数值的原始字符串表示

字符串编码数值的解码示例

假设我们有如下的JSON数据，里面的数值都是以字符串形式编码的：

package main

import (
	"encoding/json"
	"fmt"
)

// 定义结构体，数值字段使用json.Number类型
type UserInfo struct {
	ID    json.Number `json:"id"`
	Score json.Number `json:"score"`
	Age   json.Number `json:"age"`
}

func main() {
	// 字符串编码的JSON数据
	jsonStr := `{"id": "1001", "score": "92.5", "age": "25"}`
	var user UserInfo
	// 执行JSON解码
	err := json.Unmarshal([]byte(jsonStr), &user)
	if err != nil {
		fmt.Println("解码失败:", err)
		return
	}
	// 输出原始字符串值
	fmt.Println("原始ID:", user.ID.String())
	fmt.Println("原始Score:", user.Score.String())
	fmt.Println("原始Age:", user.Age.String())
	// 转换为对应数值类型
	id, err := user.ID.Int64()
	if err != nil {
		fmt.Println("ID转换失败:", err)
	} else {
		fmt.Println("转换后的ID:", id)
	}
	score, err := user.Score.Float64()
	if err != nil {
		fmt.Println("Score转换失败:", err)
	} else {
		fmt.Println("转换后的Score:", score)
	}
	age, err := user.Age.Int64()
	if err != nil {
		fmt.Println("Age转换失败:", err)
	} else {
		fmt.Println("转换后的Age:", age)
	}
}

运行上述代码，会先输出各个字段的原始字符串值，再输出转换后的数值类型结果，不会出现解码报错的情况。

使用json.Decoder设置UseNumber的场景

如果我们不想在结构体里显式声明json.Number类型的字段，也可以通过json.Decoder的UseNumber方法来全局启用json.Number解码，这种方式适合处理动态结构的JSON数据：

package main

import (
	"encoding/json"
	"fmt"
	"strings"
)

func main() {
	jsonStr := `{"price": "39.9", "count": "10"}`
	// 创建Decoder并设置UseNumber为true
	decoder := json.NewDecoder(strings.NewReader(jsonStr))
	decoder.UseNumber()
	// 解码到map结构
	var data map[string]interface{}
	err := decoder.Decode(&data)
	if err != nil {
		fmt.Println("解码失败:", err)
		return
	}
	// 此时map里的值都是json.Number类型
	price := data["price"].(json.Number)
	count := data["count"].(json.Number)
	// 转换输出
	priceVal, _ := price.Float64()
	countVal, _ := count.Int64()
	fmt.Printf("价格: %.1f, 数量: %dn", priceVal, countVal)
}

注意事项

使用json.Number处理字符串编码数值时，需要注意几个问题：

• 如果JSON里的字段不是合法的数值字符串，比如{"id": "abc"}，解码时不会报错，但是后续调用Int64或者Float64方法时会返回错误，需要做错误判断
• json.Number只能处理JSON规范里的数值类型，不能处理非数值的字符串，比如带字母的字符串编码字段，还是需要用string类型接收
• 如果确定数值是整数，优先用Int64方法转换，避免用Float64出现精度丢失的问题

json.Number的设计初衷就是平衡JSON数值的灵活性和类型安全，在字符串编码数值的场景下，它比直接用string类型接收后再手动转换要更可靠，也避免了默认解码float64带来的精度问题。

Go语言json.NumberJSON解码字符串编码数值修改时间：2026-06-24 11:54:38