json.MarshalIndent 用于生成带缩进的可读JSON,参数 prefix 控制每行开头前缀,indent 控制嵌套缩进符;需确保结构体字段导出、正确使用 tag,且调用后用 string() 打印结果。

json.MarshalIndent 的基本用法和参数含义
json.MarshalIndent 是 Go 标准库中用于生成带缩进、可读性更好的 JSON 字符串的函数。它比 json.Marshal 多两个参数:prefix 和 indent,分别控制每行开头的前缀(比如空格或制表符)和嵌套层级的缩进符号。
常见写法是 json.MarshalIndent(data, "", " "):第二个参数为空字符串表示不加行首前缀,第三个参数 " " 表示每层缩进两个空格。
- 如果传入
"\t"作为indent,会用制表符缩进,但注意某些终端或编辑器对制表符宽度渲染不一致,可能影响对齐 -
prefix不是“全局前缀”,而是每行开头都加一次;比如设为"→ ",输出每行都会以→开头,包括第一行 - 如果
data是nil或含不可序列化字段(如函数、未导出字段),仍会返回错误,和json.Marshal行为一致
为什么有时候格式化后还是单行?
最常见原因是误用了 json.Marshal 而非 json.MarshalIndent,或者调用时传了空字符串或零长度的 indent 参数(如 "" 或 " " 但实际没生效)。
另一个隐蔽问题是:你可能在调试时直接打印了 []byte,而没转成 string——Go 的 []byte 默认打印是切片字面量形式,看起来像乱码或单行。
立即学习“go语言免费学习笔记(深入)”;
- 务必检查是否真的调用了
json.MarshalIndent,而不是拼写成了json.MarshallIndent(少一个a) - 确认返回的
err为nil,否则可能因结构体字段未导出或含chan/func导致退化为json.Marshal的紧凑输出 - 打印时用
fmt.Println(string(b)),不是fmt.Println(b)
结构体字段不显示?导出规则和 tag 控制
Go 的 JSON 序列化只处理**导出字段**(首字母大写),小写字段默认被忽略,这跟 json.Marshal 完全一致,MarshalIndent 并不改变这个行为。
字段是否出现在输出中,取决于结构体定义和 json tag:
- 未加
json:tag 的导出字段会原名输出;加了json:"name"则用指定名称 -
json:"-"表示该字段完全忽略;json:",omitempty"表示值为零值时跳过(注意:指针 nil、字符串空、数字 0、切片 nil/空等) - 如果字段是私有(小写开头),即使加了 tag 也无效,不会出现在输出里
- 嵌套结构体同理——每一层都要满足导出 + 正确 tag 才能格式化显示
性能和生产环境注意事项
json.MarshalIndent 比 json.Marshal 多做字符串拼接和换行插入,内存分配更多、速度更慢,不适合高频或大数据量场景(比如日志批量序列化、API 响应流式生成)。
- 开发/调试阶段用
MarshalIndent没问题;上线后 API 输出建议用Marshal,前端或调试工具自己格式化 - 如果必须返回缩进 JSON(如配置导出接口),注意响应体体积增大,尤其深层嵌套时,
indent字符会重复多次 - 不要在循环里反复调用
MarshalIndent处理同一结构——提前缓存结果,或用bytes.Buffer+json.Encoder配合SetIndent更可控
真正容易被忽略的是:缩进只是人眼友好的假象,JSON 规范本身不区分格式,任何解析器都只认语法正确性。别为了“好看”牺牲可维护性,比如把 MarshalIndent 当作数据校验手段——该出错时还是会出错,只是报错位置可能更难定位。










