Beego 支持在结构体字段上同时使用 form、valid 和 orm 等多个 struct tag，只需以空格分隔各组 key:"value" 形式即可，无需分号或逗号；这是 Go 原生反射机制的约定，也是 Beego 各模块协同工作的基础。
beego 支持在结构体字段上同时使用 `form`、`valid` 和 `orm` 等多个 struct tag，只需以空格分隔各组 `key:"value"` 形式即可，无需分号或逗号；这是 go 原生反射机制的约定，也是 beego 各模块协同工作的基础。
在 Beego 开发中，一个字段常需承担多重职责：前端表单绑定（form）、服务端参数校验（valid）、数据库映射（orm）。例如，用户提交的服务配置需经表单解析 → 校验规则拦截 → 写入数据库，这三个环节分别由 Beego 的 Controller.ParseForm、Valid 模块和 ORM 模块处理。它们各自读取对应 tag，互不干扰——关键在于tag 必须符合 Go 语言的 struct tag 规范：即以空格分隔多个 key:"value" 对，且 key 不可重复。
✅ 正确写法（推荐）：
type Service struct {
Id uint64 `form:"id" valid:"Required;Range(1, 9223372036854775807)" orm:"pk;auto"`
Name string `form:"name" valid:"Required;MinSize(2);MaxSize(64)" orm:"size(64);null"`
Secret string `form:"secret" valid:"Required;MinSize(16)" orm:"column(secret_key);size(255)"`
Disabled bool `form:"disabled" valid:"Optional" orm:"default(false)"`
}
⚠️ 常见错误与注意事项：
-
禁止使用分号
;或逗号,分隔多个 tag：如`form:"id"; orm:"pk"`是非法语法，Go 编译器会报错invalid character U+003B ';'； -
键名（key）必须唯一：同一字段不可重复定义
form或valid，否则后定义的会覆盖前者； - 值（value）中的引号必须为英文双引号：单引号或中文引号会导致解析失败；
-
valid标签需配合controller.Valid()调用才生效：仅声明不触发校验； -
orm标签若含pk，必须确保全局模型注册时该字段类型与数据库主键兼容（如uint64需配orm:"pk;auto"+ MySQLBIGINT UNSIGNED）； -
字段必须导出（首字母大写）：非导出字段无法被
reflect访问，所有 tag 均无效。
? 进阶提示：
当模型需适配不同上下文（如 API 请求 vs 数据库存储），可借助自定义方法解耦逻辑。例如，将敏感字段 Secret 的 ORM 映射与 Form 绑定分离：
// 存储时加密写入
func (s *Service) BeforeInsert() error {
s.Secret = encrypt(s.Secret)
return nil
}
此时 orm:"column(secret_key)" 仍控制数据库列名，而 form:"secret" 保持原始字段名，实现关注点分离。
掌握多 tag 的空格分隔规范，是写出高内聚、低耦合 Beego 模型的第一步——它让同一结构体既能驱动 Web 表单、又能承载业务规则、还可精准映射数据库，真正践行 Beego “模块化乐高”设计哲学。
