0

0

Golang struct如何定义与使用_结构体基础语法说明

P粉602998670

P粉602998670

发布时间:2026-01-13 03:59:09

|

558人浏览过

|

来源于php中文网

原创

Go中struct是唯一基础单元,字段首字母大小写决定导出性,推荐字段名赋值初始化,匿名字段实现组合式字段提升,方法接收者选值或指针取决于是否修改原值,私有字段不参与JSON序列化和ORM映射。

golang struct如何定义与使用_结构体基础语法说明

Go 语言中没有“类”,struct 就是你组织数据的唯一基础单元——它不是语法糖,而是内存布局、序列化、方法绑定的共同载体。定义和使用看似简单,但字段可见性、初始化顺序、指针语义这些细节一旦出错,轻则字段访问失败,重则序列化丢数据、方法不生效。

如何正确定义 struct:大小写决定能否跨包访问

结构体字段是否导出(即能否被其他包访问),只看首字母大小写,和是否加 publicprivate 关键字完全无关:

  • Name string → 导出字段,外部包可读写
  • age int → 未导出字段,仅当前包内可用(哪怕你加了注释或 tag,外部也无法访问)
  • 字段类型必须紧贴字段名后,不能写成 Name: string(那是 map 初始化语法)
  • 同名字段不允许重复,但不同结构体之间可以重名(type User struct{ ID int }type Order struct{ ID int } 完全合法)
type User struct {
    ID    int    `json:"id"`
    Name  string `json:"name"`
    email string // 小写,外部包无法访问
}

三种初始化方式,选错一种就埋下维护雷

初始化不是“能跑就行”,它直接影响可读性、字段遗漏风险和后续扩展成本:

  • 推荐:字段名赋值(字面量) —— 明确、安全、支持部分赋值:u := User{ID: 123, Name: "Alice"},未填字段自动为零值(email 为空字符串)
  • 慎用:顺序赋值 —— 必须填满所有字段,且顺序与定义严格一致:u := User{123, "Alice", "a@example.com"};一旦结构体新增字段或调整顺序,所有这类初始化都会静默错位
  • 按需:指针初始化 —— u := &User{ID: 123} 更直观;u := new(User) 返回 *User,但所有字段仍为零值,需手动赋值,无明显优势

嵌套与匿名字段:复用 ≠ 继承,提升字段有优先级规则

Go 不支持继承,但通过匿名字段实现“字段提升”(field promotion),这是组合式设计的关键:

Prisms AI
Prisms AI

无代码构建AI应用的平台

下载

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

  • 具名嵌套:Addr Address → 访问需写 u.Addr.City
  • 匿名嵌套:Address(无字段名)→ u.Cityu.Address.City 都合法;若冲突(比如 UserAddress 都有 City),优先使用直接字段(u.City
  • 匿名字段只能是命名类型(如 Person),不能是基础类型(intstring)或未命名结构体
type Address struct { City, Zip string }
type User struct {
    Name   string
    Address // 匿名字段
}
u := User{Name: "Bob", Address: Address{City: "Shanghai"}}
fmt.Println(u.City) // 输出 "Shanghai",字段被提升

方法接收者选值还是指针?不看大小,先看是否要改原值

接收者类型不是性能优化题,而是语义题:你写的这个方法,是否需要修改调用者的原始数据?

  • 值接收者 func (u User) SetName(n string) → 方法内对 u.Name 赋值,不影响原始变量(传的是副本)
  • 指针接收者 func (u *User) SetEmail(e string) → 可修改原始 User 实例的字段,且调用时 u.SetEmail("x@y.z")(&u).SetEmail("x@y.z") 都合法(Go 自动取址)
  • 同一类型的方法集必须统一:如果已有指针接收者方法,就不能再为该类型定义值接收者方法(否则方法集不一致,接口实现可能失败)

最容易被忽略的是:结构体字段的可见性在反射、JSON 序列化、数据库 ORM 中全部生效——私有字段(小写)不会被 json.Marshal 输出,也不会被 gorm 映射到数据库列。别等上线后发现 API 返回空字段才回头翻文档。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

178

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

226

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

337

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

208

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

388

2024.05.21

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

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

194

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

189

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

192

2025.06.17

Java 项目构建与依赖管理(Maven / Gradle)
Java 项目构建与依赖管理(Maven / Gradle)

本专题系统讲解 Java 项目构建与依赖管理的完整体系,重点覆盖 Maven 与 Gradle 的核心概念、项目生命周期、依赖冲突解决、多模块项目管理、构建加速与版本发布规范。通过真实项目结构示例,帮助学习者掌握 从零搭建、维护到发布 Java 工程的标准化流程,提升在实际团队开发中的工程能力与协作效率。

10

2026.01.12

热门下载

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

精品课程

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

共101课时 | 8.2万人学习

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

共39课时 | 3.1万人学习

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

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