如何使用Golang处理JSON文件_GolangJSON文件序列化技巧

11次阅读

Go 语言 JSON 处理核心是 encoding/json 库,需掌握结构体标签、嵌套解析、错误处理及流式读写;字段须导出,用 json:"name" 映射,omitempty 忽略零值,inline 内嵌,RawMessage 延迟解析。

如何使用 Golang 处理 JSON 文件_GolangJSON 文件序列化技巧

Go 语言处理 JSON 文件的核心是 标准库 encoding/json,关键在于理解结构体标签、嵌套数据解析、错误处理和流式读写。不需要第三方库,但得用对方法。

定义结构体并正确使用 JSON 标签

Go 通过结构体字段标签(如 json:"name")控制序列化 / 反序列化行为。字段必须首字母大写(导出),否则无法被 JSON 包访问。

  • 基础映射:字段名不一致时用标签对齐,例如 UserName string `json:"user_name"`
  • 忽略字段:用 json:"-" 完全跳过该字段;用 json:",omitempty" 在值为零值(空字符串、0、nil 等)时省略输出
  • 嵌套结构:直接内嵌结构体或指针,JSON 会自动展开;若需保留原字段名,加 json:",inline"

读取 JSON 文件到结构体(反序列化)

推荐先用 os.ReadFile 一次性读入内存,再用 json.Unmarshal 解析。适合中小文件;大文件考虑 json.Decoder 流式解析。

  • 检查错误不能省略:解析失败常见于字段类型不匹配、JSON 格式错误、未导出字段
  • 支持多种输入源:文件、HTTP 响应体、字符串(用 strings.NewReader 转换)
  • 示例:err := json.Unmarshal(data, &user)user 必须是指针

将结构体写入 JSON 文件(序列化)

json.Marshal 得到 字节 切片,再写入文件;需要 格式化输出(带缩进)则用 json.MarshalIndent

立即学习go 语言免费学习笔记(深入)”;

  • 写文件前确保目录存在:os.MkdirAll(filepath.Dir(filename), 0755)
  • 写入后调用 file.Sync() 可选,确保数据落盘(尤其日志类场景)
  • 中文不转义:设置 json.Encoder.SetEscapeHTML(false)(配合 json.NewEncoder 使用)

处理动态或未知结构的 JSON

当字段不确定或需灵活遍历时,用 map[string]interface{}json.RawMessage 延迟解析。

  • json.RawMessage 是字节切片别名,可暂存未解析的 JSON 片段,避免重复解码
  • 解析后类型断言要谨慎,建议配合 errors.Is 或类型检查(如 v, ok := data["items"].([]interface{})
  • 复杂嵌套推荐先用在线 工具(如 json-to-go)生成结构体,再手动调整标签

基本上就这些。Golang 的 JSON 处理不复杂但容易忽略标签和导出规则,写几个小例子跑通一遍,后面就顺了。

星耀云
版权声明:本站原创文章,由 星耀云 2025-12-12发表,共计1166字。
转载说明:转载本网站任何内容,请按照转载方式正确书写本站原文地址。本站提供的一切软件、教程和内容信息仅限用于学习和研究目的;不得将上述内容用于商业或者非法用途,否则,一切后果请用户自负。本站信息来自网络,版权争议与本站无关。
text=ZqhQzanResources