本文介绍如何在 go 中优雅地解析可能为单个对象（map）或对象数组（slice）的 json 数据，并统一提取其中的 email 字段，避免运行时 panic，兼顾类型安全与代码可维护性。
本文介绍如何在 go 中优雅地解析可能为单个对象（map）或对象数组（slice）的 json 数据，并统一提取其中的 email 字段，避免运行时 panic，兼顾类型安全与代码可维护性。
在实际开发中，API 返回的 JSON 结构常存在“弹性”设计：同一字段名（如 data）可能在不同场景下返回单个对象（{"email": "..."}）或对象数组（[{"email": "..."}]）。若强行使用 interface{} + 类型断言，不仅逻辑冗长、易出错，还丧失编译期类型检查优势。
推荐做法是优先尝试结构体解码，利用错误反馈进行分支判断——这比反射或双重 interface{} 断言更简洁、健壮且符合 Go 的错误处理哲学。
以下是一个生产就绪的解决方案：
package main
import (
"encoding/json"
"fmt"
)
type EmailItem struct {
Email string `json:"email"` // 注意：原始示例中 json tag 写成了 `json:email`（缺引号），应为 `json:"email"`
}
func extractEmails(data []byte) ([]string, error) {
var single EmailItem
var slice []EmailItem
// 先尝试解析为单个对象
if err := json.Unmarshal(data, &single); err == nil {
return []string{single.Email}, nil
}
// 失败则尝试解析为对象数组
if err := json.Unmarshal(data, &slice); err == nil {
emails := make([]string, len(slice))
for i, item := range slice {
emails[i] = item.Email
}
return emails, nil
}
return nil, fmt.Errorf("failed to unmarshal JSON as either single object or array")
}
func main() {
// 示例 1：JSON 数组
b := []byte(`[{"email":"<a class="__cf_email__" data-cfemail=\"214459404c514d4461554452550f424e4c\" href=\"/cdn-cgi/l/email-protection\">[email protected]</a>"}]`)
// 示例 2：JSON 对象
c := []byte(`{"email":"<a class="__cf_email__" data-cfemail=\"7f1a071e120f131a3f0b1a0c0b511c1012\" href=\"/cdn-cgi/l/email-protection\">[email protected]</a>"}`)
// 统一处理
if emails, err := extractEmails(b); err == nil {
fmt.Printf("Array input → %v\n", emails)
}
if emails, err := extractEmails(c); err == nil {
fmt.Printf("Object input → %v\n", emails)
}
}✅ 关键优势说明：
立即学习“go语言免费学习笔记（深入）”；
- 类型安全：全程使用具名结构体 EmailItem，字段名、类型、JSON 映射关系清晰可控；
- 错误驱动流程：利用 json.Unmarshal 的明确错误返回做控制流，语义直观，无隐式 panic；
- 可扩展性强：如需支持嵌套字段（如 user.profile.email），只需调整结构体定义即可；
- 零反射开销：不依赖 reflect 包，性能更优，也更易调试与测试。
⚠️ 注意事项：
- JSON tag 必须使用双引号包裹（json:"email"），否则无法生效；
- 若输入既不是合法对象也不是合法数组（如纯字符串、null 或格式错误），函数将返回明确错误，调用方应妥善处理；
- 对于超大规模数组，可考虑流式解析（如 json.Decoder 配合 io.Reader），但本例中预加载内存解析已足够高效。
通过这种“先单后多、错误即分支”的模式，你既能保持代码简洁性，又能确保对不规则 JSON 输入的鲁棒性，是 Go 生态中处理柔性 API 响应的典型实践。
