基于GORM的数据库开发Golang环境搭建与代码生成器编译-Golang-PHP中文网

应锁定gorm稳定版本如v1.5.4，避免go get直接拉取预发布版导致兼容问题；正确配置驱动、tablename()、gorm标签及环境适配，确保automigrate与查询正常。

基于gorm的数据库开发golang环境搭建与代码生成器编译

直接 go get gorm.io/gorm 很可能引入不兼容的预发布版本（比如 v2.3.0-xxx），导致 db.Create() 返回值类型错乱、Preload 行为异常。GORM v2 正式版应锁定在语义化版本上。

用 go mod init your-project-name 初始化模块，确保 go.mod 里有 go 1.19 或更高版本声明
显式指定稳定版本：go get gorm.io/gorm@v1.5.4（截至 2024 年底最广泛验证的稳定版）或 @v1.5.5
配套驱动必须匹配：PostgreSQL 用 go get gorm.io/driver/postgres，MySQL 用 go get gorm.io/driver/mysql，别混用 github.com/go-sql-driver/mysql
如果已有旧项目升级，检查 go.sum 是否残留 gopkg.in/yaml.v2 等冲突依赖，手动删掉后 go mod tidy

gormgen 是官方推荐的基于 AST 的结构体生成工具，但它不是 go install 即装即用的命令——它依赖当前工作目录下的 go.mod 和数据库连接信息，且二进制默认输出到 $GOBIN，而非 $GOPATH/bin。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

先执行 go env -w GOBIN=$HOME/go/bin（或你习惯的路径），再 go install gorm.io/gen@latest
运行前确保 $GOBIN 在 $PATH 中，否则 shell 找不到 gen 命令
生成时必须在项目根目录（含 go.mod）下执行，否则 gen 无法解析 import 路径，报错 failed to load package: no packages found
连接字符串中密码含特殊字符（如 @、/）必须 URL 编码，否则 gen 解析失败，例如密码 p@ss/word 要写成 p%40ss%2Fword

GORM 默认将结构体名转为蛇形小写作为表名（UserProfile → user_profile），但真实业务库往往用复数、带前缀或大小写混合的表名（如 tbl_user、Users）。不重写 TableName()，查询永远 0 结果。

生成后立刻打开 model/user.go，在结构体后补上：
```
func (User) TableName() string {
    return "users"
}
```
如果表名是 schema 限定的（如 PostgreSQL 的 public.users），返回 "public.users"，GORM 会原样使用
别用 gorm.Model 嵌入来“偷懒”，它不改变表名逻辑；也别依赖 db.Table("users").Find(&u) 临时绕过——这会让关联预加载（Preload）失效
多个环境（dev/staging/prod）表名不一致？把表名抽成变量 + 构建 tag，但要注意 runtime 无法动态改 TableName() 返回值

gorm: 标签控制映射行为，但拼写错误（比如 type 写成 tyep）、空格多一个、引号不闭合，GORM 全部忽略——不会报错，只会按默认规则处理，结果就是字段不入库、主键不识别、时间不自动更新。

主键必须显式标注：ID uint `gorm:"primaryKey"`，别只靠字段名 ID 或 id
软删除字段名固定为 DeletedAt，且必须带 gorm:"index" 才能生效；自定义字段名需额外调用 db.SetupJoinTable(...)
column: 和 columnType: 别混淆：gorm:"column:created_time" 映射字段名，gorm:"columnType:datetime" 指定建表类型（仅 migrate 时生效）
时间字段加 gorm:"autoCreateTime;autoUpdateTime"，注意是分号分隔，不是逗号；若只想更新不创建，用 autoUpdateTime:true