GoLand本身不内置GORM-Gen支持，所谓“优雅生成”本质是确保gen.go脚本路径、import路径与module声明三者对齐，否则补全失效或运行panic；关键包括gen.go须在可import路径下、OutPath用"./query"、必须通过query.Use(db).User初始化实例才能触发链式补全，且字段类型映射需显式配置（如TINYINT→int）以避免运行时类型错误。
GoLand 本身不内置 GORM-Gen 支持，所谓“优雅生成”本质是把 gen.go 脚本跑通 + IDE 能跳转补全，关键在路径、导入和初始化三处对齐，否则补全失效、调用 panic。
gen.go 必须放在项目根目录或可被 main 包 import 的路径下
GoLand 的代码补全依赖 Go 的 import 路径解析。如果 gen.go 放在 scripts/gen.go，而你项目 go.mod module 名是 example.com/myapp，那生成的 query/ 代码必须能被 import "example.com/myapp/query" 解析到。
- 生成路径
OutPath: "./query"是最安全的选择；用"../query"容易因 module 名与物理路径不一致导致 GoLand 标红 “cannot find package” - 确保
gen.go所在目录有go.mod，且其module声明与整个项目一致 - 运行前先在终端执行
go run scripts/gen.go确认无错，再让 GoLand 重新索引（File → Reload project）
query.User 不是变量，GoLand 补全只对 query.Use(db).User 有效
GoLand 能识别 query.User 类型定义，但无法补全链式调用——因为 query.User 是结构体类型别名，不是已初始化实例。真正触发补全的是 query.Use(db).User 返回的实例。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 在业务代码中写
q := query.Use(db).User，之后对q的所有点号操作（如q.Name.Eq）都能被 GoLand 正确提示 - 如果只写
query.User.Where()，GoLand 可能显示 “Unresolved reference”，这不是 bug，是类型系统限制：query.User没绑定*gorm.DB，无法推导方法集 - 避免在全局变量或 init() 中提前赋值
var q = query.Use(db).User—— 此时db很可能为 nil，运行时 panic
字段类型映射错位会让 GoLand 补全“看起来对，实际运行崩”
比如 MySQL 的 TINYINT(1) 默认映射为 int8，但你在代码里写 q.Status.Eq(1)，GoLand 不报错（因为 1 可隐式转 int8），但运行时会 panic：GORM Gen 生成的 Eq 方法签名是 func(v int8)，而字面量 1 是 int，Go 类型系统拒绝自动转换。
- 统一用
gen.FieldType("status", "int")，让生成代码里的Eq接收int，和业务习惯一致 - 布尔字段务必配
gen.FieldType("is_active", "bool")+gen.FieldRelate("is_active", "Active")，否则 GoLand 补全出q.IsActive，但底层是uint8，== true永远为 false - DECIMAL 字段用
gen.FieldType("amount", "int64")，避免 float64 精度问题 —— GoLand 补全能显示q.Amount.Gt(100)，但若生成的是float64，传100会触发类型不匹配
GoLand 无法自动识别动态条件拼接，必须用 []gen.Condition
手写 SQL 时常用 if role != "" { where += " AND role = ?" }，但 GORM Gen 的类型安全就断在这儿。GoLand 对 map[string]interface{} 或字符串拼接零提示，且编译不报错，运行才暴露逻辑缺陷。
- 正确写法是声明
var cond []gen.Condition，按需append(cond, q.Role.Eq(role))，最后q.Where(cond).Find() - GoLand 能对
q.Role.Eq补全，也能识别[]gen.Condition是合法参数类型，但不会帮你检查cond是否为空 —— 空 slice 会被忽略，这是设计行为，不是 bug - OR 条件必须用
gen.Or(q.Name.Like("%a%"), q.Email.Like("%b%"))，不能拆成两个append，否则变成 AND
最易被忽略的是：GoLand 补全是否生效，和 gen.Mode 配置强相关。比如用了 gen.WithoutContext 却在业务里传了 ctx，GoLand 可能仍显示方法签名，但编译直接失败 —— 补全只是基于生成代码的 AST，不校验调用上下文。
