struct标签本身不生效，需依赖库解析；gorm用gorm:"column:xxx"，sqlx默认读db:"xxx"，ent等生成式工具不依赖标签；非导出字段标签不可读，反引号和引号语法必须严格正确。

struct 标签本身不干任何事，数据库映射是否生效，完全取决于你用的库是否读它、怎么读它。别指望写个 db:"user_name" 就自动建表或生成 SQL——得看 gorm、sqlx、ent 或你自己写的反射逻辑有没有实现这层解析。

gorm 中 db 标签不是标准，而是 gorm 自己定义的语义

很多人误以为 db:"xxx" 是 Go 语言或 ORM 的通用约定，其实不是。gorm 用的是 gorm:"column:xxx"，而 sqlx 默认认 db:"xxx"，ent 则压根不用结构体标签做列映射，靠代码生成器驱动。

• gorm 不会读 db 标签，写了也白写；必须用 gorm:"column:user_name" 才生效
• sqlx 默认读 db 标签，但可以自定义 tag key，比如 sqlx:"user_name" + 设置 sqlx.DBTag = "sqlx"
• ent 和 sqlc 这类代码生成系工具，根本不依赖运行时反射，标签只是装饰，映射关系由 schema 文件决定
• 如果你自己写 ORM 辅助函数，想支持 db 标签，就得手动调 field.Tag.Get("db")，且只对导出字段（首字母大写）有效

标签值里带空格或等号时，必须用双引号包裹

这是硬性语法限制，错一个字符就导致 reflect.StructTag 解析失败，返回空字符串，而你可能根本没意识到标签没被读到。

• ✅ 正确：gorm:"primaryKey;autoIncrement;type:varchar(255)"
• ❌ 错误：gorm:primaryKey;autoIncrement;type:varchar(255)（缺反引号）
• ❌ 错误：gorm:"primaryKey autoIncrement"（空格分隔但没用引号，会被截断为 primaryKey）
• ⚠️ 注意：omitempty 在 json 标签里是特殊关键字，但在 gorm 里无效；not null 是 gorm 支持的 tag 值，不是所有库都认

嵌套结构体字段无法直接用标签控制数据库映射

比如你写 User struct { Profile Profile `gorm:"embedded"` }，Profile 里的字段不会自动带上 profile_ 前缀，除非你在 Profile 字段上显式加 gorm:"embedded;prefix:profile_"。

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

• gorm 的 embedded 只展开字段，不自动重命名；前缀、列名仍要靠子结构体字段自身的 gorm 标签控制
• sqlx 完全不处理嵌套，Scan 时只能映射一级字段，嵌套字段需手动赋值或用 sqlx.StructScan（但它也不解析嵌套标签）
• 如果嵌套字段含 gorm:"-" ，它会被跳过；但 json:"-" 对数据库操作无影响——标签作用域严格按库划分

反射读取标签时最容易忽略的三个细节

写通用工具或中间件时，90% 的 bug 出在反射访问环节，不是标签写错了，而是没绕过 Go 的反射限制。

立即学习“go语言免费学习笔记（深入）”；

• 非导出字段（小写开头）的 Tag 永远是空字符串，reflect 不暴露它们——哪怕你写了 db:"pwd"，field.Tag.Get("db") 也返回 ""
• 传指针进 reflect.TypeOf 时，必须先 .Elem()，否则拿到的是 *T 类型，NumField() 为 0
• Tag.Get("xxx") 返回空字符串不等于“标签不存在”，它也可能表示存在但值为空（如 json:""），真要判断是否存在得用 strings.Contains 查原始字符串

字段标签不是魔法，它是契约——你和库之间关于“谁负责解释、怎么解释”的无声协议。写的时候多看一眼文档里写的 tag key 是什么，运行时多打一行 fmt.Println(field.Tag) 确认实际值，比查十遍博客管用。