0

0

Go语言中嵌套结构体内部初始化结构体切片的完整教程

聖光之護

聖光之護

发布时间:2026-01-19 15:59:02

|

845人浏览过

|

来源于php中文网

原创

Go语言中嵌套结构体内部初始化结构体切片的完整教程

本文详解如何在go语言中正确定义并初始化嵌套结构体内的结构体切片,包括推荐的扁平化设计、两种初始化语法(键值式与顺序式)、字段导出规范及json/bson序列化注意事项。

在Go中,为嵌套结构体初始化结构体切片时,关键在于类型清晰性、字段可导出性初始化语法一致性。你提供的原始设计中存在两个典型问题:Cities 类型未导出字段 cities []City(小写首字母),导致外部无法访问或序列化;且额外封装一层 Cities 结构体并无必要,反而增加冗余。

✅ 推荐做法:直接使用导出的切片字段

最简洁、高效且符合Go惯用法的方式是将 Cities 定义为导出的 []City 字段,并确保 City 的字段也导出(首字母大写):

type State struct {
    ID     string `json:"id" bson:"id"`   // 导出字段,支持JSON/BSON序列化
    Cities []City `json:"cities" bson:"cities"`
}

type City struct {
    ID string `json:"id" bson:"id"`
}
⚠️ 注意:Go中只有首字母大写的字段(如 ID)才是导出的(exported),才能被外部包访问、被 json.Marshal 或 bson.Marshal 正确序列化。原示例中 id string 是私有字段,会导致序列化结果为空对象 {}。

✅ 初始化方式(两种等效写法)

方式一:键值式字面量(推荐,清晰可读)

state := State{
    ID: "CA",
    Cities: []City{
        {ID: "SF"},
        {ID: "LA"},
        {ID: "SD"},
    },
}

方式二:顺序式字面量(需严格按字段声明顺序)

state := State{
    "CA", // 对应 ID
    []City{{ID: "SF"}, {ID: "LA"}}, // 对应 Cities
}

? 提示:顺序式易出错(尤其结构体字段增减时),强烈建议优先使用键值式,提升代码可维护性。

❌ 原始设计的问题分析

你最初定义的 Cities 结构体:

立即学习go语言免费学习笔记(深入)”;

Stockimg AI
Stockimg AI

AI生成高质量图像、书籍封面、壁纸、海报、Logo、插画、艺术等

下载
type Cities struct {
    cities []City // 小写字段 → 私有、不可序列化、无法外部赋值
}

会导致:

  • state.Cities.cities 无法在 State 外部访问;
  • json.Marshal(state) 中 Cities 字段始终为空(因 cities 不可导出);
  • 初始化需多层嵌套,语法繁琐且无实际收益。

✅ 进阶:支持空切片与动态追加

初始化后可安全追加城市:

state.Cities = append(state.Cities, City{ID: "Sacramento"})
// 或批量添加
newCities := []City{{ID: "Oakland"}, {ID: "Berkeley"}}
state.Cities = append(state.Cities, newCities...)

总结

项目 推荐方案
结构设计 避免无意义包装结构体,直接使用 []City 字段
字段命名 使用大驼峰(ID, Cities)确保导出与序列化
初始化 采用键值式结构体字面量,明确语义,抗重构
序列化 确保所有参与序列化的字段均导出,并正确设置 json/bson tag

遵循以上实践,既能保证代码简洁性与可读性,又能确保与标准库(encoding/json、go.mongodb.org/mongo-driver/bson)无缝协作。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

412

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

533

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

310

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

74

2025.09.10

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

318

2023.08.02

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

196

2025.06.09

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

189

2025.07.04

Go中Type关键字的用法
Go中Type关键字的用法

Go中Type关键字的用法有定义新的类型别名或者创建新的结构体类型。本专题为大家提供Go相关的文章、下载、课程内容,供大家免费下载体验。

234

2023.09.06

PHP WebSocket 实时通信开发
PHP WebSocket 实时通信开发

本专题系统讲解 PHP 在实时通信与长连接场景中的应用实践,涵盖 WebSocket 协议原理、服务端连接管理、消息推送机制、心跳检测、断线重连以及与前端的实时交互实现。通过聊天系统、实时通知等案例,帮助开发者掌握 使用 PHP 构建实时通信与推送服务的完整开发流程,适用于即时消息与高互动性应用场景。

10

2026.01.19

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.4万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号