如何在 Go 中灵活解析带引号与不带引号的 JSON 数字字段

本文介绍一种专业、健壮且符合 go 惯例的方案：通过自定义类型实现 json.Unmarshaljson，使结构体字段能无缝兼容 “123.45” 和 123.45 两种 JSON 数字格式，避免运行时错误并保持高性能。

本文介绍一种专业、健壮且符合 go 惯例的方案：通过自定义类型实现 `json.unmarshaljson`，使结构体字段能无缝兼容 `”123.45″` 和 `123.45` 两种 json 数字格式，避免运行时错误并保持高性能。

在与第三方 JSON API 交互时，开发者常遇到数字字段格式不一致的问题：部分字段以原始数字形式出现（如 “price”: 29.99），而另一些却意外地被包裹在双引号中（如 “price”: “29.99”）。Go 标准库的 encoding/json 默认严格区分类型——float64 字段无法直接解码字符串，而 ,String tag 又强制要求输入为字符串，二者互斥，导致 json.Unmarshal 在混合场景下必然失败。

最推荐的解决方案是定义一个语义等价但行为可定制的浮点数类型，并为其实现 UnmarshalJSON 方法，从而在解码阶段统一处理引号逻辑：

type JSONFloat64 float64  // UnmarshalJSON 支持解析带引号或不带引号的数字字符串 func (f *JSONFloat64) UnmarshalJSON(data []byte) error {     // 去除首尾引号（仅当完整包裹在双引号中时）     if len(data) >= 2 && data[0] == '"' && data[len(data)-1] == '"' {         data = data[1 : len(data)-1]     }      var tmp float64     if err := json.Unmarshal(data, &tmp); err != nil {         return fmt.Errorf("failed to unmarshal JSON number: %w", err)     }     *f = JSONFloat64(tmp)     return nil }  // MarshalJSON 保持标准 JSON 输出格式（不加引号） func (f JSONFloat64) MarshalJSON() ([]byte, error) {     return json.Marshal(float64(f)) }

使用方式简洁直观，无需修改结构体标签或预处理 JSON：

type Product struct {     Name  string     `json:"name"`     Price JSONFloat64 `json:"price"` }  func main() {     // 两种格式均成功解析     json1 := `{"name":"Laptop","price":1299.99}`     json2 := `{"name":"Mouse","price":"49.95"}`      var p1, p2 Product     json.Unmarshal([]byte(json1), &p1) // ✅     json.Unmarshal([]byte(json2), &p2) // ✅      fmt.Printf("Price1: %.2f, Price2: %.2fn", float64(p1.Price), float64(p2.Price))     // 输出：Price1: 1299.99, Price2: 49.95 }

✅ 优势说明：

• 类型安全：底层仍为 float64，支持所有数值运算与比较；
• 零依赖：纯标准库实现，无外部包引入；
• 高性能：避免正则替换（如 regexp.ReplaceAll）带来的内存拷贝与回溯开销；
• 可扩展性强：可轻松派生 JSONInt64、JSONUint 等同类类型；
• 符合 JSON 规范：序列化时输出标准数字格式，不破坏下游兼容性。

⚠️ 注意事项：

• UnmarshalJSON 中的引号检测逻辑假设字符串无转义（如 “”123.45″” 不被支持），若需处理转义引号，应改用 json.RawMessage + json.Unmarshal 二次解析；
• 不建议在高频解码场景中对同一字段混用 string 和 number 类型——这本质是 API 设计缺陷，长期应推动上游修复；
• 若需支持 NULL 值，应将类型改为指针（*JSONFloat64）并在 UnmarshalJSON 中显式判断 data == []byte(“null”)。

综上，通过自定义 JSON 可编组类型，我们以最小侵入性解决了第三方 API 的数据格式顽疾——它不是妥协，而是 Go 类型系统力量的典型体现：清晰、可控、可持续。