Go语言开发工具:JSON、YAML与数据库表转Struct

清欢
清欢
发布时间:2026-10-15 | 5人浏览过
原创

在Go语言开发中,将JSON、YAML配置或数据库表结构手动转换为对应的 struct 既繁琐又容易出错。本文整理并演示了三款高效的Go语言开发辅助工具,涵盖在线转换网页与本地代码库,帮助您一键生成带有正确类型标注和 tag 的结构体定义,显著提升编码效率。

JSON转Go结构体:json-to-go

访问地址:https://mholt.github.io/json-to-go/

该工具无需安装环境,直接粘贴 JSON 字符串即可解析。

第1步:粘贴输入示例

目的:准备待转换的 JSON 数据源。

[
    {
        "input_index": 0,
        "candidate_index": 0,
        "delivery_line_1": "1 N Rosedale St",
        "components": {
            "primary_number": "1",
            "street_predirection": "N",
            "street_name": "Rosedale",
            "street_suffix": "St",
            "city_name": "Baltimore",
            "state_abbreviation": "MD"
        }
    }
]

第2步:获取生成的 Go 代码

目的:获得可直接复制到项目中的结构体定义。

页面右侧会实时输出对应的 struct 代码(包含自动推断的数据类型及 json tag):

type AutoGenerated []struct {
    InputIndex     int    `json:"input_index"`
    CandidateIndex int    `json:"candidate_index"`
    DeliveryLine1  string `json:"delivery_line_1"`
    Components     struct {
        PrimaryNumber      string `json:"primary_number"`
        StreetPredirection string `json:"street_predirection"`
        StreetName         string `json:"street_name"`
        StreetSuffix       string `json:"street_suffix"`
        CityName           string `json:"city_name"`
        StateAbbreviation  string `json:"state_abbreviation"`
    } `json:"components"`
}

YAML转Go结构体:yaml-to-go

访问地址:https://zhwt.github.io/yaml-to-go/

适用于需要将配置文件(如 GitLab CI、Docker Compose 等 YAML 文件)转换为 Go 结构体的场景。

第1步:粘贴 YAML 内容

目的:提供标准的 YAML 数据结构。

image: golang:latest
before_script:
  - mkdir -p $GOPATH/src/$(dirname $REPO_NAME)
  - ln -svf $CI_PROJECT_DIR $GOPATH/src/$REPO_NAME
  - cd $GOPATH/src/$REPO_NAME
stages:
  - test
  - build
  - deploy
format:
  stage: test
  script:
    - go fmt $(go list ./... | grep -v /vendor/)
    - go vet $(go list ./... | grep -v /vendor/)
    - go test -race $(go list ./... | grep -v /vendor/)

第2步:复制生成的结构体

目标状态:获得带有 yaml tag 的结构体代码。

type AutoGenerated struct {
    Image        string   `yaml:"image"`
    BeforeScript []string `yaml:"before_script"`
    Stages       []string `yaml:"stages"`
    Format       struct {
        Stage  string   `yaml:"stage"`
        Script []string `yaml:"script"`
    } `yaml:"format"`
}

数据库表转Go结构体:table-to-go

项目地址:https://github.com/gohouse/converter

除了在线网页工具,处理复杂的数据库迁移时,推荐使用本地开发的 converter 库。它支持通过命令行(CLI)或在 Go 项目中编程调用,将数据库表(如 MySQL)自动映射为带有 ORM 标签和字段的 Go 结构体。

第1步:环境准备

目的:安装依赖库或下载可执行文件。

方法A:作为 Go 模块引用(推荐)

go get github.com/gohouse/converter

方法B:下载 CLI 二进制文件

前往项目的 Releases 页面下载对应操作系统的版本,如 table2struct-linux.v0.0.3.bin。

第2步:使用命令行 (CLI) 转换

目的:快速将远程或本地数据库表导出为 .go 文件。

语法如下:

./table2struct-linux.v0.0.3.bin -file model.go -dsn 'root:root@tcp(localhost:3306)/test?charset=utf8' -table user

常用参数说明:

-dsn            string 数据库连接串(DSN)配置
-enableJsonTag  bool    是否添加 json 类型的 tag
-file           string 保存生成代码的目标路径
-packageName    string 指定包名 (默认取名为: package model)
-prefix         string 去除字段名的表前缀 (例如 prefix_user 可设置为 prefix_)
-realNameMethod  string 是否生成返回表名的结构体方法,填入方法名即可 (如 TableName)
-table          string 要转换的具体数据表名称
-tagKey         string 自定义 Tag 的 Key 值 (默认为 orm)

第3步:使用 Go 代码方式转换(编程式调用)

目的:集成到内部平台或进行更灵活的自定义配置。

以下代码展示了如何通过初始化对象、配置个性化属性,最后执行转换流程:

package main
import (
    "fmt"
    "github.com/gohouse/converter"
)

func main() {
    // 1. 初始化转换器
    t2t := converter.NewTable2Struct()
    
    // 2. 个性化配置
    t2t.Config(&converter.T2tConfig{
        RmTagIfUcFirsted: false, // 如果字段首字母是大写,不额外加tag
        TagToLower:       false, // tag中的key名是否转为小写
        UcFirstOnly:      false, // 字段首字母大写的同时,其余字母是否转小写
    })
    
    // 3. 执行转换链
    err := t2t.
        Table("user").                      // 指定要迁移的表
        Prefix("prefix_").                  // 表名前缀
        EnableJsonTag(true).                // 开启 json tag
        PackageName("model").               // 输出包的名称
        TagKey("orm").                      // 设置主要 tag key 为 orm
        RealNameMethod("TableName").        // 添加获取表名的函数
        SavePath("/Users/fizz/go/model.go").// 文件保存绝对路径
        Dsn("root:root@tcp(localhost:3306)/test?charset=utf8"). // 连接字符串
        Run()                               // 启动运行

    fmt.Println(err)
}

第4步:查看生成结果

运行后将在 SavePath 指定的路径生成代码。以用户表为例,生成的 Go 代码如下:

package model
import "time"

type User struct {
    Id        int     `json:"Id" orm:"Id"`             // 主键ID
    Email     string  `json:"Email" orm:"Email"`       // 邮箱
    Password  string  `json:"Password" orm:"Password"` // 密码
    CreatedAt string  `json:"CreatedAt" orm:"CreatedAt"`
}

func (*User) TableName() string {
    return "user"
}
以上就是Go语言开发工具JSON、YAML与SQL表转Struct的详细内容,更多关于Go语言工具的资料请关注本站其它相关文章!
相关标签:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表