本文介绍一种专业、健壮且符合 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: %.2f\n", 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 类型系统力量的典型体现：清晰、可控、可持续。
