使用struct tag控制JSON输出，避免反射性能损耗，统一响应格式，处理时间与数字精度问题，可提升Go Web服务的JSON序列化效率与一致性。
在构建 Golang Web 服务时，JSON 是最常用的通信格式。正确高效地处理 JSON 序列化不仅影响接口的性能，还关系到数据的一致性与可读性。Golang 内置的 encoding/json 包功能强大，但若不加优化，容易成为性能瓶颈或引发意料之外的问题。
1. 使用 struct tag 控制 JSON 输出
Go 中结构体字段必须以大写字母开头才能被外部访问，但实际返回的 JSON 字段通常使用小写命名。通过 struct tag 可以灵活控制序列化后的字段名。
例如：
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Email string `json:"email"`
Password string `json:"-"` // 不输出
}
使用 json:"-" 可忽略敏感字段，如密码。还可以使用 json:",omitempty" 实现零值省略：
立即学习“go语言免费学习笔记（深入）”；
Age int `json:"age,omitempty"` // 零值时不输出
2. 避免不必要的反射开销
encoding/json 在序列化时依赖反射，对性能敏感的服务应尽量减少动态结构的使用。建议：
- 优先使用具体结构体而非 map[string]interface{}
- 避免频繁解析未知结构的 JSON，必要时缓存类型信息
- 对高频接口，考虑使用代码生成工具（如 easyjson）预生成编解码函数
例如使用 easyjson 后，序列化性能可提升 2~5 倍，尤其适合大数据量场景。
3. 统一响应格式与错误处理
Web 接口通常需要统一的响应结构，例如：
{
"code": 0,
"message": "success",
"data": { ... }
}
定义通用响应结构有助于前端处理：
type Response struct {
Code int `json:"code"`
Message string `json:"message"`
Data interface{} `json:"data,omitempty"`
}
func JSON(w http.ResponseWriter, status int, v interface{}) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(status)
json.NewEncoder(w).Encode(v)
}
在 handler 中统一返回：
JSON(w, http.StatusOK, Response{Code: 0, Message: "ok", Data: user})
4. 处理时间与数字精度问题
默认情况下，Go 的 time.Time 会序列化为 RFC3339 格式，可能不符合前端需求。可通过自定义类型解决：
type CustomTime struct {
time.Time
}
func (ct *CustomTime) MarshalJSON() ([]byte, error) {
return []byte(fmt.Sprintf(`"%s"`, ct.Time.Format("2006-01-02 15:04:05"))), nil
}
对于浮点数，注意 float64 在 JSON 中可能丢失精度。若涉及金额，建议传输字符串或整数（如分单位）。
基本上就这些。合理使用 tag、避免反射、统一响应结构、处理好时间和类型，就能写出高效可靠的 JSON 接口。不复杂但容易忽略细节。
