xorm 框架通过 `xorm:"name"` 标签或全局配置来处理结构体与字段名的大小写映射,默认情况下它会将驼峰命名的字段自动转换为下划线命名(例如 `username` 变为 `user_name`),若需自定义映射规则,可直接在结构体字段上添加指定列名的标签。

如何自定义单个字段的数据库列名
当默认的下划线转换不符合需求时,可以在结构体字段上显式指定列名。XORM 会优先读取标签中的值,忽略默认的转换逻辑。这种方式适用于需要保留特定大小写格式或完全自定义列名的场景。

package main
import (
"fmt"
"log"
"xorm.io/xorm"
_ "xorm.io/xorm/drivers/mysql"
)
type User struct {
ID int64 `xorm:"id"`
Name string `xorm:"user_name"`
Age int `xorm:"age"`
}
func main() {
engine, err := xorm.NewEngine("mysql", "root:root@tcp(127.0.0.1:3306)/test")
if err != nil {
log.Fatal(err)
}
defer engine.Close()
// 同步表结构
err = engine.Sync2(new(User))
if err != nil {
log.Fatal(err)
}
// 插入数据验证
user := &User{Name: "Alice", Age: 25}
_, err = engine.Insert(user)
if err != nil {
log.Fatal(err)
}
fmt.Println("Insert success, column mapping applied.")
}
如何全局修改列名转换策略
如果项目中所有结构体都需要统一的命名转换规则,可以通过配置引擎的 `Mapper` 属性来全局生效。XORM 提供了 `SnakeMapper`(默认)和 `CamelMapper` 等内置映射器,也可以实现 `TableNameMapper` 接口来自定义逻辑。这避免了在每个字段上重复编写标签。

package main
import (
"fmt"
"log"
"strings"
"unicode"
"unicode/case"
"xorm.io/xorm"
_ "xorm.io/xorm/drivers/mysql"
)
// 自定义映射器:将驼峰转为全大写
type UpperMapper struct{}
func (u UpperMapper) TableName(table string) string {
return strings.ToUpper(table)
}
func (u UpperMapper) ColumnName(table, col string) string {
var sb strings.Builder
for i, r := range col {
if unicode.IsUpper(r) && i > 0 {
sb.WriteString("_")
}
sb.WriteRune(unicode.ToUpper(r))
}
return sb.String()
}
type Product struct {
ID int64 `xorm:"pk autoincr"`
ProductName string `xorm:"product_name"`
Price float64
}
func main() {
engine, err := xorm.NewEngine("mysql", "root:root@tcp(127.0.0.1:3306)/test")
if err != nil {
log.Fatal(err)
}
defer engine.Close()
// 应用自定义映射器
engine.SetMapper(UpperMapper{})
// 同步表结构
err = engine.Sync2(new(Product))
if err != nil {
log.Fatal(err)
}
fmt.Println("Synced with custom upper-case mapper.")
}
使用 CamelMapper 处理纯驼峰到纯驼峰的映射
在某些数据库中,列名可能直接使用驼峰命名而非下划线。此时可以使用 XORM 内置的 `CamelMapper`。该映射器会将结构体的驼峰字段直接作为列名,不进行下划线转换。这对于兼容某些 NoSQL 风格或特定 ORM 设计的数据库非常有用。











