本文介绍使用 go-gorp orm 创建表时，如何准确指定列名（如 pid）和字符串字段最大长度（如 varchar(50)），解决因结构体标签解析异常导致列名错误（如生成 name:xyz,size:50）的问题。
本文介绍使用 go-gorp orm 创建表时，如何准确指定列名（如 pid）和字符串字段最大长度（如 varchar(50)），解决因结构体标签解析异常导致列名错误（如生成 name:xyz,size:50）的问题。
Go-Gorp 是一个轻量级的 Go 语言 ORM 库，支持自动建表、映射结构体字段到数据库列等功能。但在实际使用中，开发者常误以为结构体字段的 db 标签可直接支持 size 等高级选项（如 db:",size:50" 或 db:"name:xyz,size:50"）。事实是：Gorp 主流稳定版本（v2.x）并不支持在 db 标签中解析 size、type 等 DDL 相关参数——这些功能仅存在于早期未合并的 dev 分支中，官方主干已移除该设计。
✅ 正确做法是：先通过 AddTableWithName 注册结构体，再使用 ColMap() 显式获取列映射对象，调用 SetMaxSize()、SetNotNull()、SetUnique() 等方法精细控制列定义。
以下为完整、可运行的示例代码：
type Data struct {
ID int `db:"pid"` // 映射到列名 "pid"
Name string `db:"name"` // 映射到列名 "name"（注意：此处不能加 size）
}
// 注册表并设置主键
table := Dbm.AddTableWithName(Data{}, "data_test").SetKeys(true, "ID")
// ⚠️ 关键步骤：显式配置列属性
table.ColMap("name").SetMaxSize(50) // → 生成 VARCHAR(50)
table.ColMap("pid").SetAutoIncr(true) // 可选：设为自增主键（若需）
// 执行建表（仅当表不存在时创建）
err := Dbm.CreateTablesIfNotExists()
if err != nil {
log.Fatal("Failed to create table:", err)
}
? 注意事项：
- 结构体字段名必须首字母大写（如 ID、Name），否则无法被 Gorp 导出和反射访问；
- db 标签中仅支持列名重命名（如 db:"pid"）和忽略字段（db:"-"），不支持 size、type、notnull 等内联 DDL 指令；
- ColMap() 的参数是结构体字段名（非数据库列名），即 ColMap("Name") 或 ColMap("ID")，而非 "name" 或 "pid" —— 但 Gorp 实际允许传入列名别名（如 "name"），前提是该别名已在 db 标签中声明；为保险起见，推荐统一使用结构体字段名（本例中为 "Name"）；
- 若需指定 MySQL 特定类型（如 TEXT、TINYINT），可使用 SetSqlType("TEXT") 替代 SetMaxSize；
- 建表后如需修改列结构，请使用原生 SQL（Gorp 不提供 ALTER TABLE 封装）。
总结：Gorp 的设计理念是“映射优先、控制分离”——结构体标签负责 字段-列名映射，而列的约束、长度、类型等 DDL 属性应通过 ColMap() 链式调用显式声明。掌握这一范式，即可避免标签解析混乱，构建语义清晰、可维护性强的数据库 schema。
