ThinkPHP模型定义关键在命名规范与配置匹配：类名User对应表user，文件路径app/model/User.php，命名空间严格遵循PSR-4；表前缀统一在database.php配置，手动指定表名需设protected $table；命名错误或自动加载不匹配将导致查空或Class not found。
模型定义这件事，可远不止“写个类就行”那么简单。真正的关键，在于四个核心配置项是否与真实的数据库表结构严丝合缝地匹配——但凡错一个，create() 就可能静默失败，find() 大概率查不到数据，时间字段更是分分钟给你报错。
模型生成命令要不要加 --migration？
这完全取决于你手头是否已经存在对应的数据表。如果表是现成的（比如从旧系统迁移过来的），那么直接运行 php artisan make:model User 就足够了。反之，如果项目是从零开始，需要新建表，这时候才需要加上 -m 或 --migration 参数。不过要记住，它只是生成一个空的迁移文件，并不会自动执行 migrate 命令。
- 已有表：跳过迁移步骤，把精力集中在模型本身的配置上。
- 新项目且无表：加上
-m，之后记得手动运行php artisan migrate。 - 一个常见的误区：别指望用类似
--model的参数从表结构反向生成模型——Lara vel 并不支持这种功能，市面上也没有工具能完美地从数据库表自动生成一个包含正确$fillable属性的模型类。
$table 和 $primaryKey 为什么必须核对？
Eloquent 模型默认会按照类名来推导表名（比如 User 对应 users），同时假定主键字段就是 id。一旦实际情况有出入，比如表名其实是 my_users，或者主键是 user_id，而你又没有显式声明，麻烦就来了：
User::find(1)实际执行的 SQL 是：SELECT * FROM users WHERE id = 1→ 结果要么查不到数据，要么直接报表不存在。User::create([...])在插入时会忽略user_id字段，可能导致主键冲突或 NULL 值错误。- 关联查询（例如
$user->posts）也会因为表名或外键不匹配而返回一个空集合。
所以，最稳妥的做法是：打开数据库管理工具，确认真实的表名和主键字段名，然后在模型里明确写死：
protected $table = 'my_users'; protected $primaryKey = 'user_id';
$fillable 填错会导致什么？
必须明确一点：$fillable 是白名单，不是可有可无的配置。只要你使用了 create()、update() 或者批量赋值（$user->fill([...])），就必须在这个数组里列全所有允许写入的字段。漏掉一个，那个字段就永远别想写进数据库，而且系统通常不会给出任何错误提示。
- 典型场景：模型里只写了
'name'和'email'，但表里还有个'a vatar_url'字段，结果用户头像始终无法保存。 - 安全红线：如果不小心写成了
$guarded = []（即黑名单为空），就等于对所有字段开放写入权限，这为恶意注入（比如伪造is_admin字段）敞开了大门。 - 调试技巧：打印
$user->getAttributes()可以查看哪些字段被成功赋值到了模型实例上，再回头对比你的$fillable列表，就能快速定位问题。
$timestamps 设为 false 后还要注意什么？
设置 public $timestamps = false; 确实能避免因找不到 created_at 和 updated_at 字段而引发的报错。但它仅仅关闭了 Eloquent 的自动维护功能，**并不会阻止你手动去写入时间数据**：
- 如果你的表使用的是自定义的时间字段，比如
create_time，那么你需要在模型的creating事件监听器中手动赋值：$this->attributes['create_time'] = now()->format('Y-m-d H:i:s'); - 注意不要混用配置：当
$timestamps = false时，再去设置const CREATED_AT = 'create_time'是毫无意义的，因为 Eloquent 根本不会去读取这个常量。 - 时间字段的类型也要匹配：MySQL 的
DATETIME类型对应 PHP 的Carbon对象，而TIMESTAMP类型则可能存在时区转换的陷阱，尤其是在本地开发环境和线上服务器时区设置不一致的情况下。
这里有个最容易被忽略的细节：即便关闭了时间戳，当你调用 sa ve() 方法时，Eloquent 仍然会尝试更新所有非主键字段，其中就包括那个你可能没动过的 updated_at —— 如果这个字段在数据库里不允许为 NULL 且没有设置默认值，那么程序就会抛出错误。
