Go语言开发工具:JSON、YAML与数据库表转Struct
在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"
}免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









