推荐 json.NewDecoder 而非 json.Unmarshal，因其流式解析不缓存全文、内存友好，且报错含具体行号便于调试；json.Unmarshal 需全量加载字节切片，大文件易致内存暴涨且仅报偏移量。
Go 读取 JSON 文件最稳妥的方式是 os.Open + json.NewDecoder，而不是先用 os.ReadFile 全量加载再 json.Unmarshal ——后者在大文件下容易触发内存暴涨，且错误定位模糊。
为什么推荐 json.NewDecoder 而非 json.Unmarshal
json.NewDecoder 是流式解析器，边读边解，不缓存整个文件内容；而 json.Unmarshal 必须持有完整 []byte，对几百 MB 的配置或日志 JSON 很危险。更重要的是：json.NewDecoder 在报错时能返回具体行号（如 invalid character '}' looking for beginning of object key string），json.Unmarshal 只报偏移量，调试成本高。
- 文件小（os.ReadFile 写起来更短
- 文件可能较大、需稳定服务（如配置中心）→ 必须用
json.NewDecoder - 想提前校验字段缺失或类型错 →
json.NewDecoder支持设置DisallowUnknownFields()阻止未知字段
结构体字段必须导出且标签对齐
Go 的 encoding/json 包只能访问首字母大写的导出字段；如果 JSON 字段是 "db_host"，但结构体写成 Db_host string 或漏了 json:"db_host" 标签，该字段永远为零值（""、0、false），且不会报错 —— 这是最隐蔽的坑。
- 字段名必须首字母大写（如
DBHost），否则解析静默失败 - 务必显式加
json:"db_host"标签，别依赖默认映射（Go 默认转驼峰，DBHost → dbHost，不是db_host） - 嵌套对象用匿名或具名结构体，例如
Server struct{ Host string `json:"host"` }，标签写在外部字段上
处理可选字段和嵌套结构的惯用法
JSON 中常见字段缺失（如 "timeout" 可能压根没出现），直接定义为 int 会导致解析失败；正确做法是用指针或带 omitempty 的指针字段。
- 字段可选且需区分“未提供”和“值为 0” → 用指针，如
Timeout *int `json:"timeout"`，之后用if cfg.Timeout != nil判断 - 字段可选但只用于序列化（输出时为空不写）→ 用
Timeout int `json:"timeout,omitempty"`，注意这不影响反序列化 - 深层嵌套建议拆成独立结构体，比如
Settings Settings `json:"settings"`，比一堆匿名 struct 更易测试和复用
package main
import (
"encoding/json"
"log"
"os"
)
type Config struct {
DBHost string `json:"db_host"`
DBPort int `json:"db_port"`
Debug bool `json:"debug"`
Timeout *int `json:"timeout"` // 可选字段，缺失时为 nil
Server struct {
Host string `json:"host"`
Port int `json:"port"`
} `json:"server"`
}
func main() {
f, err := os.Open("config.json")
if err != nil {
log.Fatal(err)
}
defer f.Close()
var cfg Config
if err := json.NewDecoder(f).Decode(&cfg); err != nil {
log.Fatal("JSON decode error:", err)
}
if cfg.Timeout != nil {
log.Printf("timeout set to %d", *cfg.Timeout)
}
log.Printf("server: %s:%d", cfg.Server.Host, cfg.Server.Port)
}
真正容易被忽略的点是：UTF-8 编码无 BOM。哪怕 JSON 文件里有中文，只要保存为 UTF-8（无签名/BOM），Go 就能原生正确解析；一旦带 BOM，json.NewDecoder 会直接报 invalid character '' looking for beginning of value —— 这个错误信息完全不提示 BOM 问题，得靠经验或用 hexdump -C config.json | head 看前三个字节是不是 ef bb bf。
