本文详解如何在 Go 中安全、高效地读取本地 JSON 文件，并将其反序列化为可遍历的 Go 值（如 map 或结构体），重点解决 json.Unmarshal 的常见错误（如 Unmarshal(nil)）及类型断言实践。
本文详解如何在 go 中安全、高效地读取本地 json 文件，并将其反序列化为可遍历的 go 值（如 map 或结构体），重点解决 `json.unmarshal` 的常见错误（如 `unmarshal(nil)`）及类型断言实践。
在 Go 中读取 JSON 文件并将其作为“JSON 对象”使用，核心在于 正确调用 json.Unmarshal 并传入变量地址，而非变量本身。你遇到的 json: Unmarshal(nil) 错误，正是由于传递了未取地址的 data 变量——json.Unmarshal 要求第二个参数必须是一个指向可修改值的指针，否则无法将解析结果写入目标内存。
✅ 正确做法：使用 &data 传参 + 错误检查
package main
import (
"encoding/json"
"fmt"
"io/ioutil" // 注意：Go 1.16+ 推荐改用 io.ReadFile
"log"
)
func main() {
filename := "config.json"
// ✅ 步骤 1：安全读取文件（务必检查错误）
dataBytes, err := ioutil.ReadFile(filename)
if err != nil {
log.Fatalf("无法读取文件 %s: %v", filename, err)
}
// ✅ 步骤 2：声明变量并传入其地址
var jsonData interface{}
err = json.Unmarshal(dataBytes, &jsonData) // 关键：&jsonData，不是 jsonData
if err != nil {
log.Fatalf("JSON 解析失败: %v", err)
}
// ✅ 步骤 3：类型断言后安全访问（适用于动态结构）
if objMap, ok := jsonData.(map[string]interface{}); ok {
for key, value := range objMap {
fmt.Printf("键: %s → 值: %v (类型: %T)\n", key, value, value)
}
}
}
⚠️ 注意：
ioutil.ReadFile在 Go 1.16+ 已被弃用，推荐升级为io.ReadFile（行为完全一致，仅需导入"io"）：import "io" // ... dataBytes, err := io.ReadFile(filename)
? 为什么 interface{} 需要类型断言？
当使用 interface{} 接收 JSON 时，json.Unmarshal 会根据 JSON 类型自动映射为 Go 内置类型：
- JSON
object→map[string]interface{} - JSON
array→[]interface{} - JSON
string→string - JSON
number→float64（注意：JSON 数字统一转为float64，整数也如此） - JSON
boolean→bool - JSON
null→nil
因此，若 JSON 文件内容为：
{
"name": "example",
"age": 30,
"tags": ["go", "json"],
"active": true
}
则需逐层断言：
if m, ok := jsonData.(map[string]interface{}); ok {
if name, ok := m["name"].(string); ok {
fmt.Println("Name:", name)
}
if age, ok := m["age"].(float64); ok { // 注意是 float64！
fmt.Println("Age:", int(age)) // 如需 int，手动转换
}
if tags, ok := m["tags"].([]interface{}); ok {
for i, tag := range tags {
if s, ok := tag.(string); ok {
fmt.Printf("Tag[%d]: %s\n", i, s)
}
}
}
}
? 更佳实践：定义结构体（推荐用于已知 Schema）
相比 interface{}，定义结构体更安全、高效且具备编译期检查：
type Config struct {
Name string `json:"name"`
Age int `json:"age"`
Tags []string `json:"tags"`
Active bool `json:"active"`
}
// 使用方式
var config Config
err := json.Unmarshal(dataBytes, &config) // 同样需要 &
if err != nil {
log.Fatal(err)
}
fmt.Printf("Hello %s, age %d\n", config.Name, config.Age)
结构体标签（如 json:"name"）控制字段与 JSON 键的映射关系；未导出字段（小写开头）默认不会被解析。
✅ 总结要点
-
必须传地址：
json.Unmarshal(data, &v)，永远不要漏掉&； -
务必检查错误：
ioutil.ReadFile和json.Unmarshal均可能失败，忽略错误会导致静默崩溃或nil行为； -
动态解析用
interface{}+ 类型断言：适合未知结构，但需谨慎处理类型； - 静态结构优先用 struct：语义清晰、性能更好、IDE 支持强；
-
避免
fmt.Println(data)直接输出interface{}：它打印的是 Go 内部表示（如map[string]interface{}），非格式化 JSON；如需调试输出，可用json.MarshalIndent格式化：pretty, _ := json.MarshalIndent(jsonData, "", " ") fmt.Println(string(pretty))
遵循以上规范，即可稳健地将本地 JSON 文件加载为可编程操作的 Go 值。
