正确做法是直接用os.ReadFile读取[]byte后传给json.Unmarshal；结构体字段需大写导出并加json:"key"标签；优先用json.MarshalIndent生成可读JSON；动态数据用map[string]interface{}；数字默认为float64；缺失字段用指针区分nil。
直接用 json.Unmarshal 读取 JSON 文件，别先读成字符串再解析
常见错误是先用 os.ReadFile 得到 []byte，再手动转 string，最后传给 json.Unmarshal ——这多一次内存拷贝，且毫无必要。json.Unmarshal 本来就能接受 []byte。
- 正确做法：读文件后直接传给
json.Unmarshal - 结构体字段必须首字母大写（导出），否则反序列化时会被忽略
- 推荐加
json:标签明确映射字段名，避免大小写或下划线不一致导致失败
data, err := os.ReadFile("config.json")
if err != nil {
log.Fatal(err)
}
var cfg struct {
Port int `json:"port"`
Host string `json:"host"`
}
if err := json.Unmarshal(data, &cfg); err != nil {
log.Fatal(err)
}
json.MarshalIndent 是写可读 JSON 文件的默认选择
用 json.Marshal 输出的是紧凑无换行的 JSON，调试困难、Git diff 不友好。除非明确需要最小体积（如网络传输），否则本地配置文件一律用 json.MarshalIndent。
- 第二个参数是 prefix（通常为空字符串），第三个是 indent（常用
" "或"\t"） - 写入前记得用
os.WriteFile或os.Create+file.Write，别漏掉错误检查 - 注意：
json.MarshalIndent不会自动格式化已有 JSON 字符串字段内容，只作用于顶层结构
cfg := map[string]interface{}{
"port": 8080,
"features": []string{"auth", "logging"},
}
b, _ := json.MarshalIndent(cfg, "", " ")
os.WriteFile("output.json", b, 0644)
处理未知结构或动态键值时，优先用 map[string]interface{} 而非 interface{}
虽然 json.Unmarshal 支持直接解到 interface{}，但后续取值要层层类型断言（v.(map[string]interface{}) → v["data"].(map[string]interface{})…），极易 panic。用 map[string]interface{} 能省掉第一层判断，也更贴近“JSON 对象”的直觉。
- 数组对应
[]interface{}，不是[]string或[]int - JSON 数字默认解析为
float64，哪怕源数据是123；需手动转int或用json.Number - 如果键名不确定（如日志中的 tag 字段），
map[string]interface{}比定义 struct 更灵活
嵌套结构里用指针字段避免零值覆盖
当 JSON 中某个对象字段可能缺失（如 "user": null 或干脆没这个 key），而你的 struct 字段是非指针类型（如 User User），反序列化后它会是零值（空结构体），无法区分“字段不存在”和“字段存在但为空对象”。用指针（*User）能保留 nil 状态。
立即学习“go语言免费学习笔记（深入）”；
-
json:标签里加omitempty只影响序列化（输出时跳过零值），不影响反序列化逻辑 - 切片字段同理：用
*[]string能区分null和[]，但多数场景用[]string+ 判断长度更简单 - 注意：
nil指针在json.Marshal时输出为null，不是跳过
encoding/json 看似简单，但字段可见性、数字类型默认行为、nil 语义这些细节，一旦忽略就容易在运行时才暴露问题。 
