Go语言通过json.Marshal将结构体序列化为JSON,需字段首字母大写并配合json标签;支持omitempty省略空字段、嵌套结构体及time.Time类型,默认输出RFC3339时间格式,可通过json.NewEncoder直接写入HTTP响应,高效返回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表示如果字段为空,序列化时会自动省略。
立即学习“go语言免费学习笔记(深入)”;
2. 处理嵌套结构体和时间类型
结构体中常包含嵌套结构或time.Time类型,也能正常序列化。
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更高效,避免中间生成字符串,适合大对象或流式输出。
4. 注意事项和技巧
- 字段必须首字母大写才能被json包访问
- 使用json:"-"可忽略不导出的字段
- map[string]interface{}也可直接序列化,适合动态结构
- 若结构体字段为指针,nil指针会转为JSON的null
基本上就这些。掌握json.Marshal和结构体标签就能应对大多数场景。不复杂但容易忽略细节,比如字段导出和标签拼写。










