用 Go 读取 JSON 文件需用 os.Open 打开文件,再通过 json.NewDecoder 解析到导出结构体,字段须首字母大写并用 json:"xxx" 标签对齐;嵌套结构和可选字段分别用嵌套结构体和指针处理,注意类型匹配与 UTF-8 编码。

用 Go 读取 JSON 文件很简单,核心是 os.Open + json.Unmarshal,关键在于结构体字段要和 JSON 字段对齐,并注意导出规则和类型匹配。
定义匹配的结构体
Go 中只有首字母大写的字段(即导出字段)才能被 json 包读写。建议用结构体字段标签(json:"xxx")显式指定映射关系,避免大小写或下划线不一致导致解析失败。
例如,JSON 内容为:
{ "db_host": "localhost", "db_port": 5432, "debug": true }对应结构体应写成:
立即学习“go语言免费学习笔记(深入)”;
type Config struct {
DBHost string `json:"db_host"`
DBPort int `json:"db_port"`
Debug bool `json:"debug"`
}
打开并解析文件
使用 os.Open 打开文件,再用 json.NewDecoder 或 json.Unmarshal 解析。推荐用 json.NewDecoder,它支持流式读取,内存更友好,也便于处理错误位置。
启明星企业抽奖程序 系统采用ASP.NET4.0 无需数据库。在企业抽奖时,请勿关闭或者刷新页面。因为系统目前没有提供保存数据功能。例如在抽二等奖和一等奖之间,可能有时间间隔。那么,此时,你可以按F11取消全屏,然后最小化页面,再单击右下角喇叭,设置无声。1.启明星抽奖程序配置说明使用说明:在lottery/lottery文件夹下,有3个文本文件。company.txt存放公司名称,award.t
- 先检查文件是否成功打开
- 用
decoder.Decode(&config)解析到结构体指针 - 务必检查解码错误,JSON 格式错误、字段类型不匹配都会在这里报错
示例代码片段:
f, err := os.Open("config.json")
if err != nil {
log.Fatal(err)
}
defer f.Close()
var cfg Config
if err := json.NewDecoder(f).Decode(&cfg); err != nil {
log.Fatal("JSON decode error:", err)
}
处理嵌套结构和可选字段
JSON 中常有嵌套对象或缺失字段。Go 支持嵌套结构体,字段标签可加 ,omitempty 表示该字段为空时不参与编码;若字段可能缺失,可设为指针或使用 interface{} + 类型断言,但更推荐用指针+零值判断。
例如:
type Config struct {
Server struct {
Host string `json:"host"`
Port int `json:"port"`
} `json:"server"`
Timeout *int `json:"timeout,omitempty"` // 可选字段,不存在时为 nil
}
之后可通过 if cfg.Timeout != nil 安全判断。
常见问题与避坑提示
- JSON 字符串中的数字被解析成 float64?——是因为用了
interface{}或没指定具体类型,务必声明为int、float64等明确类型 - 字段始终为零值?——检查结构体字段是否首字母大写,以及
json:标签是否拼写正确 - 中文乱码?——确保 JSON 文件保存为 UTF-8 编码(无 BOM),Go 原生支持 UTF-8,无需额外处理
- 想读取任意 JSON?——可用
map[string]interface{}或json.RawMessage延迟解析部分字段









