GO语言基础教程（182）Go解析JSON之编码JSON：Go语言驯服JSON指南：让你的数据“活”起来，不再当码农苦力！-优快云博客

哟，各位码友们！今天咱们来聊聊Go语言里那个天天见、却又偶尔让人抓狂的玩意儿——JSON编码。别皱眉，我知道你在想啥：“这有啥好讲的？不就是个json.Marshal吗？” 嘿，还真别说，这里头的门道比你想象的多！不信？你试试处理个带嵌套的结构体，或者想自定义字段名却手忙脚乱？别急，坐稳了，这篇“避坑指南”保你一路畅通！

一、为啥Go和JSON是“天生一对”？

Go语言自打出生就和JSON看对眼了。为啥？简单啊！Go的静态类型和结构体，跟JSON的键值对简直是天造地设。别的语言可能要折腾半天，Go里一行代码就能把结构体变成JSON字符串，速度快到让你怀疑人生。举个栗子，你写个API接口，前端传来JSON数据，Go能秒速解析成结构体；反过来，数据库查出来的数据，Go也能瞬间变成JSON甩给前端。这种默契，就像火锅配冰啤——绝了！

但注意啦！Go的严格脾气也意味着：你必须清楚每个字段的类型，想蒙混过关？门儿都没有！接下来，咱们就从最简单的操作开始，一步步拆解这个“编码魔法”。

二、基础操作：一键把结构体变成JSON

Go语言内置的encoding/json包，就是你的编码神器。核心函数就俩：json.Marshal（编码）和json.Unmarshal（解码）。今天先聚焦编码，来看个最简单的例子：

package main

import (
    "encoding/json"
    "fmt"
)

type User struct {
    Name  string
    Age   int
    Email string
}

func main() {
    user := User{Name: "张三", Age: 25, Email: "zhangsan@example.com"}
    jsonData, err := json.Marshal(user)
    if err != nil {
        fmt.Println("编码出错:", err)
        return
    }
    fmt.Println(string(jsonData))
}

运行这段代码，输出是：

{"Name":"张三","Age":25,"Email":"zhangsan@example.com"}

看到没？Go默认用结构体的字段名作为JSON键名。但这里有个小坑——字段名首字母必须大写！否则json.Marshal会直接无视它，因为小写字段在Go里是私有的。别问为什么，问就是Go的“安全强迫症”犯了。

三、进阶玩法：用结构体标签“微调”JSON

有时候，你可能不想用默认的字段名。比如前端要求用user_name，但你的结构体里是Name。这时候，结构体标签（Struct Tags） 就派上用场了！它就像给字段贴个“说明书”，告诉编码器如何操作：

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

重新运行后，输出变成：

{"user_name":"张三","user_age":25}

这里用了两个技巧：

重命名字段：json:"user_name"直接把Name映射成了user_name。
忽略空值：omitempty参数表示如果Email是空值（比如""），就直接跳过这个字段。

但注意！omitempty有局限性——它只能处理“零值”。比如整数0、空字符串""、空切片等。如果你的业务里0是有意义的，可别用它，否则数据就丢了！

四、实战骚操作：处理复杂嵌套结构

真实项目里，谁还没个嵌套对象啊？比如用户信息里包含地址。别慌，Go处理起来照样优雅：

type Address struct {
    City    string `json:"city"`
    ZipCode int    `json:"zip_code"`
}

type User struct {
    Name    string  `json:"user_name"`
    Age     int     `json:"user_age"`
    Address Address `json:"address"`
}

func main() {
    user := User{
        Name: "李四",
        Age:  30,
        Address: Address{
            City:    "北京",
            ZipCode: 100000,
        },
    }
    jsonData, _ := json.MarshalIndent(user, "", "  ")
    fmt.Println(string(jsonData))
}

这次用了json.MarshalIndent，输出会自动格式化，看着更舒服：

{
  "user_name": "李四",
  "user_age": 30,
  "address": {
    "city": "北京",
    "zip_code": 100000
  }
}

重点来了：嵌套结构体就像套娃，只要每层都写好标签，Go就能自动递归处理。这点比某些需要手动拆解的语言省心多了！

五、避坑指南：这些雷区千万别踩！

循环引用会炸：如果两个结构体互相引用，编码时会陷入死循环。比如User里有个Profile，Profile里又引用User。解决方案？用指针或者重新设计数据结构。
时间类型要特殊处理：Go的time.Time类型默认会被编码成RFC3339格式的字符串。如果你想自定义格式，得实现json.Marshaler接口：

type CustomTime time.Time

func (ct CustomTime) MarshalJSON() ([]byte, error) {
  // 自定义格式化逻辑
}

忽略字段有妙招：用json:"-"直接让字段“消失”：

type User struct {
  Password string `json:"-"` // 永远不会出现在JSON中
}

六、完整示例：打包一个真实API响应

光说不练假把式，最后来个综合案例——模拟一个用户API的响应：

package main

import (
    "encoding/json"
    "fmt"
    "time"
)

type APIResponse struct {
    Success bool        `json:"success"`
    Data    interface{} `json:"data,omitempty"`
    Error   string      `json:"error,omitempty"`
    Time    int64       `json:"timestamp"`
}

type User struct {
    ID        int    `json:"id"`
    Name      string `json:"name"`
    Email     string `json:"email,omitempty"`
    CreatedAt int64  `json:"created_at"`
}

func main() {
    // 模拟成功响应
    user := User{
        ID:        1,
        Name:      "王五",
        Email:     "wangwu@example.com",
        CreatedAt: time.Now().Unix(),
    }
    response := APIResponse{
        Success: true,
        Data:    user,
        Time:    time.Now().Unix(),
    }
    
    jsonData, _ := json.MarshalIndent(response, "", "  ")
    fmt.Println("成功响应:")
    fmt.Println(string(jsonData))
    
    // 模拟错误响应
    errorResponse := APIResponse{
        Success: false,
        Error:   "用户不存在",
        Time:    time.Now().Unix(),
    }
    errorJson, _ := json.MarshalIndent(errorResponse, "", "  ")
    fmt.Println("\n错误响应:")
    fmt.Println(string(errorJson))
}

输出结果：

// 成功响应
{
  "success": true,
  "data": {
    "id": 1,
    "name": "王五",
    "email": "wangwu@example.com",
    "created_at": 1620000000
  },
  "timestamp": 1620000000
}

// 错误响应
{
  "success": false,
  "error": "用户不存在",
  "timestamp": 1620000000
}

这个例子展示了实际开发中的常见模式：用interface{}容纳任意数据，用omitempty灵活控制字段显示。拷贝这段代码，改改就能用！