ent 是代码生成型强类型 ORM，依赖 go generate 生成 client、需显式调用 Schema.Create() 建表、且 client 必须正确初始化后使用；三者缺一不可。
ent 不是“配置驱动”或“运行时反射型” ORM，它靠代码生成 + 强类型编译检查工作；没跑过 go generate ./ent，就别想用 client.User.Create() —— 这不是 bug，是设计前提。
ent init 和 go run entgo.io/ent/cmd/ent new 的区别
两者都创建 schema 模板，但触发方式和路径控制不同：
-
ent init User：要求当前目录已存在ent/目录（通常由go mod init后手动建好），生成的文件落在ent/schema/user.go -
go run -mod=mod entgo.io/ent/cmd/ent new User：不依赖本地ent/目录，会自动创建完整结构（含ent/、ent/schema/），适合全新项目冷启动 - 二者生成的
Userstruct 都嵌入ent.Schema，字段定义函数签名一致，后续编辑无差异
为什么 ent.Open 之后还要手动调 client.Schema.Create()？
ent.Open() 只建立数据库连接并初始化 *ent.Client，它 不自动建表。Schema 创建是显式迁移动作：
- SQLite 内存模式（
file:ent?mode=memory）每次重启丢失表，必须每次运行client.Schema.Create(ctx) - MySQL/PostgreSQL 等持久库可选加
.WithAtlas(true)启用 Atlas 自动 diff 迁移，否则仍需手写Create()或用ent migrate工具 - 漏掉这步，执行
client.User.Create().SetXXX().Save()会直接 panic：no such table: users
字段改了但 client.User.Create() 没新参数？
这是 ent 最常被误解的一环：生成代码和运行时 client 是两件事。
立即学习“go语言免费学习笔记（深入）”；
-
ent generate（或go generate ./ent）才真正读取ent/schema/*.go，重新生成ent/client.go、ent/user.go等 —— 新字段只在这一步注入到方法签名里 - 改完
user.go中的Fields()却不运行生成命令，client.User.Create()的参数列表不会变，IDE 也不会补全，编译报错提示类似：unknown field "email" in struct literal - 注意：生成命令默认只扫
./ent目录，如果 schema 放在spec/schema，得配//go:generate go run -mod=mod entgo.io/ent/cmd/ent generate --target spec/schema
ent.Client 必须传参，不能全局单例？
可以全局变量存，但初始化时机必须明确可控：
-
ent.Client不是线程安全的，多个 goroutine 共享同一 client 实例没问题（底层连接池已处理），但client.Close()后整个实例失效 - 常见错误：在
init()函数里调ent.Open()，此时go.mod依赖可能未就绪，或 DB 配置还没从 env 加载，导致 panic 或空指针 - 推荐做法：在
main()或 HTTP server 启动前构造 client，并作为依赖注入进 handler/service 层，避免隐式全局状态 - 不初始化就直接用
client.User.Query()，编译期不报错，但运行时 panic：panic: runtime error: invalid memory address or nil pointer dereference
ent 的“复杂点”不在语法，而在它把“模型定义 → 代码生成 → 运行时 client 使用”拆成三个强耦合但必须手动衔接的阶段；任一环节断开，错误都发生在运行时且提示模糊。最易忽略的是：生成命令没跑、驱动没 go get、Schema.Create() 忘调 —— 这三件事，缺一不可。
