当前位置：首页 > 文章列表 > Golang > Go教程 > Golang结构体转JSON实战教程

Golang结构体转JSON实战教程

2025-09-25 09:58:29 0浏览收藏

积累知识，胜过积蓄金银！毕竟在Golang开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《Golang结构体转JSON字符串实战教程》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

Go语言通过json.Marshal将结构体序列化为JSON，需字段首字母大写并配合json标签；支持omitempty省略空字段、嵌套结构体及time.Time类型，默认输出RFC3339时间格式，可通过json.NewEncoder直接写入HTTP响应，高效返回JSON数据。

Golang实战中如何将结构体(struct)序列化为JSON字符串返回

在Go语言开发中，经常需要将结构体数据转换为JSON格式返回给前端或第三方服务。这个过程称为序列化，Go标准库encoding/json提供了json.Marshal函数来实现这一功能。只要结构体字段是可导出的（即首字母大写），就能顺利转换。

1. 基本结构体转JSON

使用json.Marshal可以将结构体转为JSON字节流，再转成字符串即可返回。

示例：

type User struct {
Name string `json:"name"`
Age int `json:"age"`
Email string `json:"email,omitempty"`
}

user := User{Name: "Alice", Age: 30, Email: ""}
data, _ := json.Marshal(user)
fmt.Println(string(data)) // {"name":"Alice","age":30}

注意json:"name"是结构体标签，用于指定JSON字段名。omitempty表示如果字段为空，序列化时会自动省略。

2. 处理嵌套结构体和时间类型

结构体中常包含嵌套结构或time.Time类型，也能正常序列化。

type Address struct {
City string `json:"city"`
State string `json:"state"`
}

type User struct {
Name string `json:"name"`
Birthday time.Time `json:"birthday"`
Addr Address `json:"address"`
}

time.Time默认输出RFC3339格式（如"2024-05-10T12:00:00Z"），如果需要自定义格式，可封装类型或使用字符串字段。

3. 返回JSON给HTTP客户端

在Web服务中，通常通过http.ResponseWriter直接写回JSON响应。

func handler(w http.ResponseWriter, r *http.Request) {
user := User{Name: "Bob", Age: 25}
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(user)
}

使用json.NewEncoder(w).Encode更高效，避免中间生成字符串，适合大对象或流式输出。