
go 原生不支持类似 `[string, int]` 的元组式数组类型,但可通过结构体、自定义类型或第三方库(如 `go-scan`)实现类型安全的解码与访问。
在处理来自 JSON 的固定结构数组(例如 ["foo", 42])时,开发者常面临类型断言冗长、易出错的问题:使用 []interface{} 后需手动写 arr[0].(string) 和 arr[1].(int),不仅代码重复,且运行时 panic 风险高(如索引越界或类型不符)。
推荐方案一:使用命名结构体(最 Go-idiomatic)
JSON 数组虽无字段名,但若其结构稳定(始终为 [string, int]),可定义对应结构体并配合 json.Unmarshal 的自定义反序列化:
type Pair struct {
Name string `json:"-"` // 不用于 JSON 对象解码
Age int `json:"-"`
}
// 实现 UnmarshalJSON 支持数组格式
func (p *Pair) UnmarshalJSON(data []byte) error {
var arr []interface{}
if err := json.Unmarshal(data, &arr); err != nil {
return err
}
if len(arr) < 2 {
return fmt.Errorf("expected array of length 2, got %d", len(arr))
}
if s, ok := arr[0].(string); !ok {
return fmt.Errorf("field 0 must be string, got %T", arr[0])
} else {
p.Name = s
}
if i, ok := arr[1].(float64); !ok { // 注意:JSON number 默认为 float64
return fmt.Errorf("field 1 must be number, got %T", arr[1])
} else {
p.Age = int(i) // 安全转换(必要时加范围校验)
}
return nil
}
// 使用示例
var p Pair
err := json.Unmarshal([]byte(`["foo", 42]`), &p)
if err == nil {
fmt.Printf("Name: %s, Age: %d\n", p.Name, p.Age) // Name: foo, Age: 42
}推荐方案二:使用 go-scan 等轻量库(适合快速原型)
如问题中所示,github.com/mattn/go-scan 提供路径式提取能力,避免手动断言:
import "github.com/mattn/go-scan"
var v interface{}
json.Unmarshal([]byte(`["foo", 42]`), &v)
var name string
var age int
if err := scan.ScanTree(v, "[0]", &name); err != nil {
log.Fatal(err)
}
if err := scan.ScanTree(v, "[1]", &age); err != nil {
log.Fatal(err)
}
fmt.Println(name, age) // foo 42✅ 优势:简洁、路径明确、错误可单独处理;
⚠️ 注意:需额外引入依赖,且 scan.ScanTree 对嵌套过深或动态结构支持有限。
为什么不直接用 [2]interface{} 或泛型?
- Go 不支持异构数组字面量(如 [2]{string, int}),数组/切片元素类型必须统一;
- 泛型(Go 1.18+)适用于同构集合(如 []T),无法约束不同位置的不同类型;
- 因此,结构体 + 自定义 UnmarshalJSON 是官方推荐、类型安全、零依赖的最佳实践。
总结:放弃“数组类型标注”的幻想,拥抱语义化结构体。它不仅提升类型安全性与可读性,还便于后续扩展(如增加字段、添加验证逻辑或支持多种 JSON 格式)。








