Go中用反射自动生成SQL字段列表的核心是遍历导出结构体字段,优先解析gorm标签的column值,其次转为snake_case,跳过gorm:"-"字段,最后拼接为逗号分隔字符串。

在 Go 中用反射自动生成 SQL 字段列表,核心是遍历结构体字段,提取字段名(或对应数据库列名),拼成逗号分隔的字符串,比如 id, name, created_at。关键在于正确处理结构体标签(如 gorm:"column:name" 或 json:"name")、忽略不导出字段、跳过被标记为忽略的字段(如 - 或 gorm:"-" )。
提取结构体字段名(支持 struct tag)
Go 的 reflect.StructField 提供了 Tag 字段,可从中解析自定义标签。常见做法是优先取 gorm 标签的 column 值,其次 fallback 到字段名本身(转小写或保持原样)。注意:字段必须是导出的(首字母大写),否则反射无法访问。
- 用
reflect.TypeOf(v).Elem()获取指针指向的结构体类型 - 遍历每个
Field,检查IsExported() - 读取
field.Tag.Get("gorm"),用简单解析(如strings.SplitN)提取column:xxx;也可用现成库如github.com/mohae/deepcopy或手写简易 parser - 若无
column,用field.Name并按需转为 snake_case(例如UserName→user_name)
跳过被忽略的字段(- 或 gorm:"-")
很多 ORM(如 GORM)约定用 - 表示忽略该字段。反射时需主动识别并跳过:
- 检查
field.Tag.Get("gorm") == "-" - 或更通用:检查
strings.TrimSpace(field.Tag.Get("gorm")) == "-" - 也支持
json:"-"或自定义标签如db:"-",按项目规范统一处理
生成字段列表字符串(含防 SQL 注入意识)
生成的字段名仅用于 SELECT / INSERT 等语句的列名部分,**不是值**,所以无需参数化。但必须确保字段名合法(只含字母、数字、下划线,不以数字开头):
立即学习“go语言免费学习笔记(深入)”;
- 建议对生成的字段名做基础校验:正则
^[a-zA-Z_][a-zA-Z0-9_]*$ - 避免直接拼接用户输入——这里字段名来自代码结构体,是可信源;但如果字段名来自配置或外部定义,需额外清洗
- 用
strings.Join(fields, ", ")拼接,注意不要多加空格影响可读性(如"id , name")
封装成可复用函数(示例)
下面是一个轻量实用版本(不依赖第三方):
func GetSQLColumns(v interface{}) []string {
t := reflect.TypeOf(v)
if t.Kind() == reflect.Ptr {
t = t.Elem()
}
if t.Kind() != reflect.Struct {
return nil
}
var cols []string
for i := 0; i < t.NumField(); i++ {
f := t.Field(i)
if !f.IsExported() {
continue
}
// 忽略 gorm:"-"
if f.Tag.Get("gorm") == "-" {
continue
}
// 优先取 gorm column
col := f.Tag.Get("gorm")
if idx := strings.Index(col, "column:"); idx != -1 {
col = strings.Split(col[idx+7:], ",")[0]
col = strings.TrimSpace(col)
} else {
col = strutil.ToSnake(f.Name) // 自己实现或用 strings.ToLower
}
if col != "" {
cols = append(cols, col)
}
}
return cols}
// 使用:cols := GetSQLColumns(&User{}) → []string{"id", "user_name", "created_at"}
基本上就这些。不需要复杂框架,几行反射 + 标签解析就能稳定生成字段列表,适合构建 DAO 层、自动迁移或通用查询封装。注意保持结构体标签一致性,比硬编码字符串更安全易维护。










