应锁定GORM稳定版本如v1.5.4，避免go get直接拉取预发布版导致兼容问题；正确配置驱动、TableName()、gorm标签及环境适配，确保AutoMigrate与查询正常。
Go mod 初始化与 GORM 依赖引入要避开 go get 直接拉 master
直接 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）编译前必须确认 Go 工作区和 GOBIN 路径
gormgen 是官方推荐的基于 AST 的结构体生成工具，但它不是 go install 即装即用的命令——它依赖当前工作目录下的 go.mod 和数据库连接信息，且二进制默认输出到 $GOBIN，而非 $GOPATH/bin。
- 先执行
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
生成的 model 文件里 TableName() 方法容易被忽略但影响巨大
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: 配置项写错一个字母就静默失效
gorm: 标签控制映射行为，但拼写错误（比如 type 写成 tyep）、空格多一个、引号不闭合，GORM 全部忽略——不会报错，只会按默认规则处理，结果就是字段不入库、主键不识别、时间不自动更新。
立即学习“go语言免费学习笔记（深入）”；
- 主键必须显式标注：
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
TableName() → 补关键标签 → db.AutoMigrate() → 查询验证。中间任何一环漏掉，后面查半天才发现是 gorm:"primaryKey" 少了个 r。 
