Sonic并非简单替换import即可加速，其性能优势依赖正确配置：需限制递归深度、禁用冗余指令集、避免map[string]interface{}泛型路径，并注意Unmarshal时nil指针、time.Time格式及错误类型差异。
Sonic 不是“换 import 就能加速”的透明替换——它快，但快得有前提；用错配置、忽略类型约束、盲目套用 map[string]interface{}，反而比标准库还慢。
为什么 sonic.Marshal 有时比 json.Marshal 还慢？
根本原因不是 sonic 本身慢，而是默认编译策略在你项目里“过度发力”：它会为每个嵌套结构体现场生成专用汇编代码，深度 10 层的订单结构体可能触发上百次 JIT 编译，构建期卡住，运行时缓存未热，首请求延迟飙升。
- 检查
go build -gcflags="-m"输出，若看到大量compiler: generated encoder for struct XXX，说明正在做无意义重复编译 - 用
sonic.Config显式限制递归深度：CompileOptions: option.CompileOptions{RecursiveDepth: 3}（90% 的业务结构体 ≤3 层） - 禁用全指令集冗余编译：构建时加
-tags "amd64 avx2"（别留着sse4 neon等不用的标签） - 避免在 hot path 上对同一 struct 反复调用
sonic.Marshal——它不缓存反射结果，和标准库一样
map[string]interface{} 是 sonic 的性能陷阱
你传个 map[string]interface{} 给 sonic.Marshal，它立刻退化到最慢路径：失去所有结构体字段信息，无法 JIT 生成专用代码，全程走泛型分支，连标准库都不如。
- 真实场景中，80% 的 JSON 输入/输出其实有稳定 schema，优先定义
type User struct { Name string `json:"name"` } - 若必须用 map（如通用网关转发），至少预热一次：
sonic.Marshal(map[string]interface{}{"a": 1})在 init 函数里跑一遍，让泛型编译器落地一次 - 别信“sonic 支持 interface{} 就等于支持动态 JSON”——它支持，但不快；快的前提是类型可推导
sonic.Unmarshal 和 json.Unmarshal 的三个关键差异
直接替换 import 后 panic 或数据丢失，大概率栽在这三处：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
-
nil *struct{}：标准库输出null，sonic 默认 panic；需提前判空或配sonic.Config{NoNullSliceOrMap: true} -
time.Time：标准库输出"2006-01-02T15:04:05Z07:00"，sonic 默认输出纳秒整数；必须注册：sonic.RegisterTimeFormat("2006-01-02T15:04:05Z07:00") - 错误类型：标准库返回
json.UnsupportedTypeError，sonic 返回sonic.InvalidCharacterError；检查要用errors.As(err, &sonic.InvalidCharacterError{})，不能只写err != nil
CGO 构建失败或 Alpine 镜像 panic 怎么办？
sonic 核心是 C++ 实现，依赖 CGO 和 libc 符号。Docker 构建失败、Alpine 下 panic "undefined symbol: __cxa_throw"，基本都是环境没对齐。
- 确认 Go 版本 ≥
1.16，且没加-tags purego（加了就强制退到纯 Go 慢实现） - Docker 构建镜像必须含
gcc和libc-dev（Debian/Ubuntu）或musl-dev（Alpine）；推荐用golang:1.21-alpine+apk add --no-cache git gcc musl-dev - 实在不能开 CGO？改用
github.com/bytedance/sonic-go（纯 Go 分支），性能约打七折，但能跑
真正卡住人的从来不是“会不会用”，而是“以为自己已经用对了”——比如开了 SortMapKeys 却没意识到它带来 10% 开销，或者把 sonic.Get 返回的 ast.Node 直接塞进 sonic.Marshal 导致 panic。这些点不写在文档首页，但线上抖动往往就来自它们。
