Golang初级项目：开发一个基础的JSON数据比对差异工具

json 比较不可靠因字段顺序不保证、零值忽略、浮点精度丢失等；应先解码再结构化比对，或用 canonicaljson 统一格式后 diff。

为什么 json.Marshal 直接比字符串不可靠

因为 go 的 json.Marshal 不保证字段顺序，且会忽略零值字段（除非显式加 omitempty），更别说浮点数精度、NaN、+0/-0 这些边界情况。直接 String(json1) == string(json2) 看似快，但只要结构体字段顺序不同或嵌套 map 无序，就必然误判。

• 使用场景：CI 中校验 API 响应快照、本地调试时比对前后端 JSON 格式一致性
• 常见错误现象："{"a":1,"b":2}" != "{"b":2,"a":1}" 返回 true，实际内容相同却报差异
• 正确做法是先解码为 map[string]Interface{} 或自定义结构体，再递归比对键值对和类型
• 注意：json.Unmarshal 对 float64 默认精度是 64 位，但若原始 JSON 含 1.0000000000000001，Go 会截断为 1.0，导致误判——此时需用 json.RawMessage + 字符串 diff 作为 fallback

用 github.com/sergi/go-diff 做结构化 diff 的前提条件

这个库本身不处理 JSON 解析，它只比对文本行或字节流。想让它输出“哪一行字段变了”，得先确保输入是格式化后、字段顺序一致的 JSON 字符串；否则 diff 结果全是“整块重写”，失去定位能力。

• 必须先用 json.MarshalIndent 统一缩进（比如 四空格），并设置 sortKeys: true（Go 1.21+ 可用 json.Encoder.SetEscapeHTML(false) 配合自定义 encoder，但排序仍需手动）
• 推荐封装一个 canonicalJSON 函数：先 json.Unmarshal → 再按 key 字典序递归排序 map → 最后 json.MarshalIndent
• 性能影响：对 >1MB 的 JSON，Unmarshal+MarshalIndent 比纯字符串 diff 慢 3–5 倍，但可读性提升极大；小数据（
• 容易踩的坑：go-diff 的 DiffStrings 默认不忽略空白，换行符差异会被当成真实变更，务必传入 diff.LineDiff{IgnoreWhitespace: true}

reflect.DeepEqual 在 JSON 比对中的适用边界

它能跳过序列化过程，直接比内存结构，速度快、语义准，但仅适用于你**完全控制输入结构**的场景——比如比对两个已知结构体变量，或明确知道 JSON 总是解析成 map[string]interface{} 和 []interface{} 的组合。

• 使用场景：单元测试中验证函数返回的 struct 是否与期望 JSON 解析结果一致
• 常见错误现象：把 json.Number("123") 和 float64(123) 当作相等（实际不等），因为 json.Unmarshal 默认用 float64 存数字，除非你传 UseNumber() 选项
• 必须统一解码方式：要么都用 json.Decoder.UseNumber()，要么都转成 float64 再比（但会丢精度）
• 兼容性注意：nil slice 和空 slice []int{} 在 reflect.DeepEqual 中视为不同，而某些 JSON 库（如 easyjson）可能把缺失字段解析为空 slice，需提前 normalize

如何让差异输出对开发者友好

终端里打印一长串 diff 行没用，关键是要指出「哪个字段路径变了」「旧值/新值是什么」。这需要在递归比对过程中记录路径，而不是依赖最终字符串 diff。

立即学习“go语言免费学习笔记（深入）”；

• 建议用 github.com/mitchellh/mapstructure 先转成 map[string]interface{}，再写一个带 path []string 参数的递归比对函数
• 示例逻辑：if v1, ok1 := a[key]; ok1 { if v2, ok2 := b[key]; ok2 { compare(v1, v2, append(path, key)) } else { fmt.Printf("- %s: %vn", strings.Join(append(path, key), "."), v1) } }
• 避免把 time.Time 直接塞进 map——JSON 解析后是字符串，比对时类型不一致会全错；统一转成 string 或 int64 再进 map
• 最容易被忽略的一点：JSON 中的 null 解析为 Go 的 nil interface{}，而结构体字段如果是 *string，解码后是 (*string)(nil)，两者在 reflect.DeepEqual 中不等，但语义上都代表“空”。要不要等价，得按业务定规则，不能默认