Ent需显式调用Create/Save写入数据库，无脏检查与自动flush；Time字段需统一时区处理；代码生成要求类型导出；GraphQL易触发N+1，应预加载或批量加载。
Ent 生成的 Client 必须显式调用 Create 或 Save 才写入数据库
很多人以为 Ent 像某些 ORM 那样“赋值即生效”，结果发现改了 user.Name 却没进库——Ent 是纯函数式、无脏检查、无自动 flush 的设计。所有变更都得通过明确的 mutation 方法触发。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
client.User.Create().SetName("alice").Save(ctx)是插入；user.Update().SetName("alice").Save(ctx)是更新，二者不能混用 - 如果已有实体（比如从
Query查出来的*User），必须用.Update()开头，直接改字段再调.Save()会报"object has no ID"错误 - 批量插入别手写循环：用
client.User.CreateBulk(...)，性能差一个数量级
Schema 定义里 field.Time 默认不带时区，MySQL/PostgreSQL 行为不一致
Ent 的 field.Time 底层映射到 SQL 类型时，SQLite 和 PostgreSQL 默认存 UTC 时间戳，但 MySQL 默认按本地时区解析 DATETIME 字段，导致查出来的时间偏移几小时。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 统一用
field.Time("created_at").SchemaType(map[string]string{"mysql": "TIMESTAMP"})强制 MySQL 存TIMESTAMP（带时区语义） - Go 层始终用
time.UTC构造时间，避免time.Now()返回本地时区值 - 测试时在 Docker 里跑 MySQL 容器要加
-e TZ=UTC，否则本地环境和 CI 时区不一致会触发偶发失败
entc gen 失败常见于 ent/schema 目录外引用了未导出类型
Ent 代码生成器只扫描 ent/schema 下的 Go 文件，且要求所有被 ent.Field 或 ent.Edge 引用的类型必须是导出的（首字母大写）。一旦写了 field.Enum("status").Values(statusValues...)，而 statusValues 是小写变量，就会报 "cannot load schema: undefined: statusValues"。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 枚举值统一定义为导出常量或导出切片，例如
var StatusValues = []string{"active", "inactive"} - 自定义钩子（hook）或校验器（validator）不要放在 schema 文件里，放到
ent/hook或ent/validate目录下，再通过ent.Schema.Mixin引入 - 升级 Ent 版本后务必清空
ent/generated并重跑go run entgo.io/ent/cmd/entc@latest generate ./ent/schema，缓存残留会导致奇怪的类型错误
GraphQL + Ent 组合时，N+1 查询问题比预期更隐蔽
Ent 自身没有懒加载机制，但 GraphQL resolver 习惯按字段拆解逻辑，比如用户列表返回每个用户的 Posts，若 resolver 里对每个 User 单独调 user.QueryPosts().All(ctx)，就触发 N+1。Ent 不会自动合并这些查询。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
client.User.Query().WithPosts().All(ctx)预加载，注意WithXxx()生成的字段名是Edges.Xxx，不是Xxx - GraphQL resolver 中避免在循环里调
QueryXxx()，优先用LoadXxx(ctx, []*User)批量加载（需配合ent.LoadGroup） - 开启 Ent 日志：
ent.Log(entsql.NewLogHook())，观察实际执行了几条 SQL，比看文档更准
