一文讲透SQL 转 Go Struct：从手动映射到自动化生成的完整指南

一文讲透SQL 转 Go Struct从手动映射到自动化生成的完整指南在 Go 语言的后端开发中数据库表结构与 Go 结构体的映射是每天都要面对的基础工作。无论是使用 GORM、XORM 还是原生 database/sql定义与数据表对应的 Struct 都是数据层开发的第一步。本文将系统梳理 SQL 到 Go Struct 的转换规则、常见坑点与高效方案帮你彻底掌握这项基础技能。一、为什么 SQL 转 Go Struct 是 Go 开发者的刚需Go 语言是强类型静态语言操作数据库必须先定义对应的数据模型。一张数据表有多少字段结构体就要定义多少个字段还要兼顾字段类型的精准匹配int、varchar、datetime、decimal 等结构体标签的规范书写gorm、json、xml 等命名风格的统一蛇形表名 → 驼峰结构体空值场景的处理指针类型、sql.Null 系列主键、索引、默认值等元信息的保留对于一张十几个字段的表手动写 Struct 不仅耗时还极易出现拼写错误、类型不匹配、标签漏写等问题。项目表越多重复劳动量越大出错概率也越高。二、SQL 数据类型与 Go 类型的标准映射这是转换的核心基础。以 MySQL 为例主流 ORM如 GORM遵循以下类型映射规则SQL 数据类型推荐 Go 类型说明INT / INTEGERint / int32普通整数字段BIGINTint64长整型常用于主键TINYINT / SMALLINTint8 / int16小整数、状态位VARCHAR / CHAR / TEXTstring字符串类型FLOAT / DOUBLEfloat32 / float64浮点数DECIMAL / NUMERICfloat64 或 decimal 第三方库高精度金额建议用专用库DATE / DATETIME / TIMESTAMPtime.Time需导入 time 包BOOLEAN / TINYINT(1)bool布尔值JSONstring 或 map[string]interface{}建议用 string 或自定义类型BLOB / BINARY[]byte二进制数据重要提示允许为 NULL 的字段建议使用指针类型如*string、*int或sql.NullString、sql.NullInt64等类型否则零值可能会与业务真实值混淆。三、结构体标签的完整写法Go 通过 Struct Tag 来实现字段与数据库列的映射最常用的是gorm和json两种标签。1. gorm 标签核心规则typeUserstruct{IDint64gorm:column:id;primaryKey;autoIncrementUsernamestringgorm:column:username;type:varchar(64);not nullEmail*stringgorm:column:email;type:varchar(128)CreatedAt time.Timegorm:column:created_at;type:datetime;autoCreateTime}常用 gorm 标签项column:xxx指定数据库列名primaryKey标记主键autoIncrement自增not null非空约束type:xxx指定字段类型default:xxx默认值autoCreateTime/autoUpdateTime自动填充创建/更新时间2. json 标签与 omitemptytypeUserstruct{IDint64json:idUsernamestringjson:usernameEmail*stringjson:email,omitempty}omitempty的作用是当字段为零值nil、空字符串、0时序列化 JSON 会自动忽略该字段常用于可选字段。但要注意业务上零值有意义的字段如状态为 0不要加omitempty。四、命名风格转换规则数据库通常使用下划线命名snake_caseGo 结构体使用大驼峰PascalCase字段使用小驼峰camelCase。表名 → 结构体名user_info→UserInfoorder_detail→OrderDetail列名 → 结构体字段名user_name→UserNamecreated_at→CreatedAt转换规则很简单按下划线分割单词每个单词首字母大写再拼接起来。五、空值处理的三种方案数据库字段允许为 NULL 时Go 侧有三种常见处理方式方案一指针类型最常用typeUserstruct{Avatar*stringgorm:column:avatar}优点直观nil 即代表 NULLGORM 原生支持。缺点使用时需要判空不能直接取值。方案二sql.Null 系列importdatabase/sqltypeUserstruct{Avatar sql.NullStringgorm:column:avatar}优点标准库支持自带 Valid 字段标记是否有效。缺点序列化 JSON 不方便结构较笨重。方案三使用默认值不允许 NULL在设计表时给字段设置默认值如空字符串、0字段不允许 NULLGo 侧直接使用基础类型。这是最简单的方案也是很多团队的规范。六、常见坑点与最佳实践不要忽略字段顺序结构体字段顺序建议与表结构顺序保持一致便于维护。主键字段建议放在第一位约定俗成也符合多数 ORM 的识别习惯。时间类型统一用 time.Time不要用 string 存时间失去类型安全。decimal 不要用 float涉及金额的高精度字段推荐使用shopspring/decimal等第三方库。JSON 字段谨慎用 map结构固定的 JSON 建议定义子结构体提升可读性。结构体首字母必须大写Go 语言可见性规则小写字段 ORM 无法反射。七、高效工具推荐在线 SQL 转 Go Struct理解了上述原理后日常开发中完全没必要手动逐字段写结构体。这里推荐一款免费好用的在线工具——码剑客 SQL 转 Go Struct。工具核心功能一键转换粘贴 CREATE TABLE 语句瞬间生成完整 Go 结构体多标签支持支持 gorm、json 等常用标签自由切换命名风格可选下划线、驼峰自由配置空值处理灵活可选择指针类型或普通类型omitempty 开关JSON 标签是否启用 omitempty 一键切换ID 字段自定义支持统一添加 ID 后缀等个性化配置使用步骤打开工具地址https://www.majk.cn/zh-CN/tools/sql-to-go-struct在左侧输入框粘贴你的 SQL 建表语句根据项目规范选择标签类型、命名风格、空值处理方式右侧即时生成 Go 结构体代码复制即可使用工具完全免费无需登录打开即用非常适合日常快速生成数据模型。对于有多张表的项目可以显著减少重复劳动避免手写出错。八、总结SQL 转 Go Struct 看似是简单的体力活实则涉及类型系统、空值语义、ORM 约定等诸多细节。理解背后的映射规则能帮你避开很多隐性 Bug而善用自动化工具则能把宝贵的时间留给真正的业务逻辑。推荐大家收藏这款在线工具日常建表后直接粘贴生成效率提升非常明显。也欢迎分享给身边写 Go 的朋友。工具直达https://www.majk.cn/zh-CN/tools/sql-to-go-struct