json.decoder.decode() 能稳住内存因按需解析单个json值后立即释放，峰值仅几kb；而json.unmarshal需全量加载字节，易oom。
json.Decoder.Decode() 为什么能稳住内存不爆
因为它根本不等整个文件读完——Decode() 只从绑定的 io.Reader（比如 *os.File 或 http.Response.Body）里按需读取下一个合法 JSON 值（一个对象、一个字符串、一个数字），解析完就释放，内存峰值通常只有几 KB。而 json.Unmarshal 必须先拿到完整 []byte，你调 os.ReadFile 或 io.ReadAll 的那一刻，文件就全进内存了。
- 真正流式起点：传
*os.File、bufio.Reader或原始http.Response.Body给json.NewDecoder，别碰ReadAll - 常见误用：
body, _ := io.ReadAll(resp.Body); json.Unmarshal(body, &v)—— 这和 Python 里json.load(open())一样危险，完全绕过流式能力 - 性能差异不是“快一点”，是“OOM 还是稳住”：GB 级文件下，
Unmarshal几秒内触发runtime: out of memory，Decode()仍维持 KB 级 RSS
顶层是 JSON 数组时，Decode(&item) 会卡死或 panic
直接写 for { dec.Decode(&item) } 解析 [{"a":1},{"b":2}] 类型文件，第一次 Decode() 就试图把整个数组加载成 []T，又爆内存；如果目标是 map[string]interface{}，则只解第一个对象，下次 Decode() 遇到 ] 就报 invalid character '}' after top-level value。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 正确做法分三步：
dec.Token()检查并吃掉'['→for dec.More() { }循环 → 每次循环内调dec.Decode(&item) -
dec.More()返回false不代表出错，可能是刚读完最后一个元素；此时再调一次dec.Token()会返回']'，必须检查并跳出 - 高频错误：循环条件只判
err == io.EOF，漏掉!dec.More()判断，导致多 Decode 一次，直接 panic
字段动态或结构不一致时，别硬套 struct
日志、ETL 数据常混着不同 "type" 的对象（{"type":"user",...} 和 {"type":"event",...}），强行定义统一 struct 容易字段缺失 panic，用 map[string]interface{} 又分配大量小对象拖慢 GC。
- 推荐方案：字段不确定处声明为
json.RawMessage，例如Ext json.RawMessage `json:"ext"`—— 底层只是原 JSON 字节的 subslice，零解析开销 - 后续真要用时，再对单个
RawMessage调json.Unmarshal，避免全局反序列化 - 注意：
json.RawMessage不能直接用作map的 value 类型（会 panic），只能放在 struct 字段或 slice 元素里 - 若 key 名动态（如指标名），用
map[string]json.RawMessage，但要校验 key 长度防恶意输入
容易被忽略的边界问题
流式不是万能银弹——BOM、空行、复用 reader、未清错误状态都会让 Decode() 在看似正常的位置突然失败。
-
invalid character 'N' looking for beginning of value：大概率是文件开头有 UTF-8 BOM 或空行；bytes.TrimLeft只适用于小文件（它会把首段全读进内存），大文件应换bufio.NewReader+ 手动跳过 - 同一个
io.Reader被多个json.Decoder复用？缓冲区错位，Decode()读到残渣字节，直接报语法错 - 某次
Decode()返回非io.EOF错误（如字段类型不匹配）后，没处理就继续循环？decoder 内部状态已坏，后续调用必然失败 -
Decoder.DisallowUnknownFields()在流式场景下慎用——它对每一行/每个对象单独校验，API 字段渐进增加时会频繁中断
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
