Golang反射生成SQL字段方法解析

“纵有疾风来，人生不言弃”，这句话送给正在学习Golang的朋友们，也希望在阅读本文《Golang反射生成SQL字段列表方法》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新Golang相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

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 等语句的列名部分，**不是值**，所以无需参数化。但必须确保字段名合法（只含字母、数字、下划线，不以数字开头）：

• 建议对生成的字段名做基础校验：正则 ^[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 层、自动迁移或通用查询封装。注意保持结构体标签一致性，比硬编码字符串更安全易维护。

今天关于《Golang反射生成SQL字段方法解析》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！