ThinkPHP6.x模型需严格遵循命名规范与配置要求：类须置于app/model/下、命名空间为app\model、继承think\Model，并匹配表名、主键及时间戳字段，否则将报错或功能失效。
ThinkPHP6.x 的模型不是“必须继承才能用”的抽象容器，而是以 think\Model 为基类、配合数据库配置和命名约定自动映射数据表的轻量对象。直接继承它，就能获得查询、保存、验证等能力——但前提是表名、主键、时间戳字段得对得上。
模型类文件位置和命名必须严格匹配规范
TP6 使用「应用目录 + 模型命名空间」自动解析模型路径，不按规则放，new User() 或 User::find(1) 都会报 Class 'app\model\User' not found。
- 模型类必须放在
app/model/目录下（不能是app/Model或app/models） - 类名用驼峰（如
User），对应表名默认是小写+下划线（user）；若表名是user_info，类名仍为User，但需在模型中显式设置protected $name = 'user_info'; - 命名空间必须是
app\model，不能漏掉app\或写成app\Model（大小写敏感）
继承 think\Model 后要立即确认基础配置是否生效
刚建好 app/model/User.php 并写完 class User extends \think\Model，不代表就能查数据——TP6 默认开启严格模式，表不存在、字段不存在、主键没设都会直接抛异常。
- 检查数据库连接是否已配置（
config/database.php中'default' => 'mysql'及对应配置项存在） - 确认数据表存在且有主键（TP6 要求必须有主键，否则
save()、update()会失败） - 若表中无
create_time/update_time字段，关闭自动时间戳：protected $autoWriteTimestamp = false; - 若主键不是
id，必须声明：protected $pk = 'user_id';
save() 和 create() 不是同一类操作，别混用
save() 是实例方法，用于已有模型实例的数据写入或更新；create() 是静态方法（已废弃），TP6 推荐用 create() 的替代方案是 new static($data)->save() 或更清晰的 static::create($data)。
立即学习“PHP免费学习笔记（深入）”；
- 新增数据建议统一用
User::create(['name' => '张三', 'email' => 'z@x.com'])，它会自动实例化并调用save() - 更新数据优先走主键查找再赋值：
$user = User::find(5); $user->name = '李四'; $user->save();，而不是User::create(['id'=>5, 'name'=>'李四'])（后者可能触发插入而非更新） - 批量写入用
User::insertAll([ ... ])，不要循环调用save()，性能差且事务难控制
关联查询前先确认外键和模型关联定义是否双向一致
比如 User 有 hasmany('Order')，那 Order 模型里就必须有 belongsTo('User')，且外键字段名（如 user_id）要在两个模型中明确声明，否则 $user->orders 返回空数组却不报错，极难排查。
-
User.php中写：public function orders() { return $this->hasMany(Order::class, 'user_id'); } -
Order.php中写：public function user() { return $this->belongsTo(User::class, 'user_id'); } - 关联字段名不写默认找
user_id，但如果订单表用的是uid，两个模型都得显式传参，缺一不可 - 调试时用
dump($user->orders()->getSql())看生成的 SQL，比盲猜快得多
模型看似简单，但 TP6 把约定和配置耦合得很紧：一个字母大小写不对、一个下划线多写、一个 $pk 忘声明，就卡在「查不到」或「存不进」。动手前花两分钟核对 config/database.php、表结构、模型路径和命名空间，比后面花二十分钟翻日志强得多。
