jsoniter 替换 encoding/json 通常提速 2–5 倍，关键在理解差异、正确配置与规避坑；它通过编译期类型推导、零拷贝解析、懒解析 Any 等优化性能，支持零修改迁移、fastpath 生成及定制配置，但需注意 RawMessage、自定义接口、RFC 严格性等边界场景。
用 jsoniter 替换 Go 标准库的 encoding/json，通常能带来 2–5 倍的序列化/反序列化速度提升，尤其在处理大量小对象或嵌套结构时效果更明显。关键不只在“换库”，而在于理解差异、正确配置和规避常见坑。
为什么 jsoniter 更快
标准库为通用性和安全性做了大量反射和运行时类型检查，而 jsoniter 在编译期做更多类型推导，支持零拷贝解析、预分配缓存、跳过字符串转义等优化。它还提供 Any 类型实现懒解析，避免不必要的结构体构建。
基础替换：零修改迁移
绝大多数场景下，只需把 import 和函数名替换即可，语义完全兼容：
- 将
import "encoding/json"改为import jsoniter "github.com/json-iterator/go" - 把
json.Marshal换成jsoniter.Marshal，json.Unmarshal换成jsoniter.Unmarshal - 无需改结构体标签（如
json:"name"），也支持omitempty、string等标准行为
进阶提速：启用 fastpath 和自定义配置
默认 jsoniter 已比标准库快，但开启编译期代码生成（fastpath）可再提速 30%–60%：
立即学习“go语言免费学习笔记（深入）”；
- 安装代码生成工具：
go install github.com/json-iterator/go/cmd/jsoniter@latest - 在结构体上方加注释：
//go:generate jsoniter -i . -o ./json_gen.go - 运行
go generate，生成专用 marshal/unmarshal 函数，绕过反射 - 对高频使用的结构体（如 API 请求/响应体）优先生成
也可手动配置 jsoniter 实例以禁用安全限制（仅限可信数据）：
var cfg = jsoniter.ConfigCompatibleWithStandardLibrary.WithoutTypeCheck() var json = cfg.Froze()
这会跳过字段类型校验，适合已知输入格式严格的内部服务。
注意边界：哪些情况不建议强切
不是所有场景都适合直接替换：
- 依赖
json.RawMessage延迟解析且后续频繁修改内容的逻辑——jsoniter 的Any更灵活，但需调整用法 - 使用了
json.Marshaler/Unmarshaler接口且内部调用了标准库函数——需确保自定义方法里也用 jsoniter - 需要严格遵循 RFC 7159（比如空格/换行敏感的协议交互）——jsoniter 默认更宽松，可通过
cfg.Indention = true对齐格式 - 交叉编译或 CGO 禁用环境——jsoniter 纯 Go 实现，无影响；但 fastpath 生成的代码也不依赖 CGO
基本上就这些。换库本身很简单，真正起效的是结合 fastpath + 合理配置 + 针对性生成。压测时建议用真实业务 payload 对比，别只看 hello world benchmark。
