如何格式化Golang反序列化后的JSON数据并提取变量？

我用以下Go代码调用API获取JSON数据，并用json.Unmarshal反序列化为map[string]interface{}类型：

// Create an HTTP client with the API key.
client := &http.Client{}
req, err := http.NewRequest("GET", url, nil)
if err != nil {
    log.Fatal("Error creating request:", err)
}
req.Header.Add("Authorization", "Bearer "+apiKey)

// Make the HTTP request to fetch JSON data.
resp, err := client.Do(req)
if err != nil {
    log.Fatal("Error making HTTP request:", err)
}
defer resp.Body.Close()

// Read the JSON response into a byte slice.
data, err := ioutil.ReadAll(resp.Body)
if err != nil {
    log.Fatal("Error reading JSON data:", err)
}

// Unmarshal the JSON data into a map.
var target map[string]interface{}
err = json.Unmarshal(data, &target)
if err != nil {
    log.Fatalf("Unable to unmarshal JSON due to %s", err)
}

执行后得到的数据格式混乱，很难提取变量进行计算，请问该如何处理这个数据？

1. 定义匹配的结构体（最推荐） #

如果API返回的JSON结构固定，直接定义对应结构体来反序列化，数据类型明确，提取时无需繁琐的类型断言，代码可读性和可维护性更强。

假设API返回的JSON结构如下：

{
  "id": 123,
  "name": "test",
  "metrics": {
    "value": 45.6
  }
}

对应的结构体定义：

type APIResponse struct {
    ID      int     `json:"id"`
    Name    string  `json:"name"`
    Metrics struct {
        Value float64 `json:"value"`
    } `json:"metrics"`
}

修改反序列化代码：

var target APIResponse
err = json.Unmarshal(data, &target)
if err != nil {
    log.Fatalf("Unable to unmarshal JSON due to %s", err)
}
// 直接提取数据计算
total := target.Metrics.Value * 2

2. 格式化输出JSON（用于调试查看） #

如果只是想直观理清数据结构，可将反序列化后的map重新序列化为带缩进的JSON字符串：

formattedData, err := json.MarshalIndent(target, "", "  ")
if err != nil {
    log.Fatal("Error formatting JSON:", err)
}
fmt.Println(string(formattedData))

输出的JSON会有清晰的层级，方便你确认数据嵌套关系。

3. 类型断言逐层提取数据 #

如果必须使用map[string]interface{}，可通过类型断言逐层提取目标数据：

// 提取顶层字符串字段
name, ok := target["name"].(string)
if !ok {
    log.Fatal("name字段类型不是string")
}

// 提取嵌套的map字段
metrics, ok := target["metrics"].(map[string]interface{})
if !ok {
    log.Fatal("metrics字段类型不是map")
}
// 从嵌套map中提取数值字段
value, ok := metrics["value"].(float64)
if !ok {
    log.Fatal("value字段类型不是float64")
}

// 执行计算逻辑
result := value * 1.5

注意每次类型断言都要检查ok值，避免因类型不匹配触发panic。

4. 用第三方库简化复杂JSON提取 #

若JSON结构复杂且嵌套较深，可使用专门的JSON查询库（如gabs或gjson），通过路径直接提取数据，无需逐层断言。以gjson为例：

// 直接从原始JSON字节数据中提取指定路径的数值
value := gjson.GetBytes(data, "metrics.value").Float()
result := value * 3

使用前需通过go get安装对应库，比如go get github.com/tidwall/gjson。

内容的提问来源于stack exchange，提问作者Kalana Madusara