ThinkPHP通过命名规则自动绑定模型与表：类名User对应表名user，表前缀在database.php统一配置；类名UserProfile对应tp_user_profile；文件路径为app/model/User.php，命名空间需严格匹配PSR-4规范。
模型类名和表名怎么自动对应？
ThinkPHP 默认靠命名规则自动绑定模型与数据表，不是靠配置，也不是靠注释——这是新手最容易卡住的地方。比如数据库里有 tp<em>user</em> 表，模型类名就得是 User（去掉前缀 tp，驼峰化，首字母大写），文件路径是 app\model\User.php。如果表名是 tp_user_profile，那类名必须是 UserProfile，不能叫 Profile 或 Userprofile。
- 类名错一个字母、大小写不对、多/少下划线，
select()就会查空数组或报“表不存在” - 表前缀在
database.php配置里统一设置，模型里不写前缀；想手动指定表，用protected $table = 'tp_user';，但会绕过前缀配置，慎用 - 如果项目用了多库或多前缀，别依赖自动匹配，老老实实设
$table，否则上线后查不到数据还找不到原因
为什么 new User() 没反应，或者提示 Class not found？
这不是模型写错了，大概率是自动加载没对上。ThinkPHP 6+ 默认使用 PSR-4 自动加载，要求命名空间和目录结构严格一致：app\model\User 对应 app/model/User.php，中间是斜杠，不是反斜杠，也不能是 App\Model\User（首字母大写）。
- 文件名必须和类名完全一致：类叫
User，文件就得叫User.php，不是user.php或UserModel.php（除非你主动设了$name） - 命名空间漏写、写成
app\Model（缺小写model）会导致new User()找不到类 - 控制器里用
use app\model\User;是必须的；直接写User::select()而不 use，PHP 会当成当前命名空间下的类，自然报错
什么时候必须写 $table / $name / $pk？
只有打破约定时才需要显式声明。默认规则够用：类名 User → 表名 user → 主键 id。但现实里常遇到这些情况：
- 表名带前缀且无法全局统一（比如遗留系统混用
tp<em></em>和cms）→ 用protected $table = 'cms_user'; - 主键不是
id，而是uid或member_id→ 加protected $pk = 'uid';，否则find(123)查不到 - 类名和表名完全不沾边（比如叫
Member但对应user表）→ 用protected $name = 'user';，它比$table更轻量，只改表名不改库/前缀 - 设了
$table就别设$name，两者冲突时$table优先，但会忽略数据库配置里的前缀，容易埋坑
模型方法调用总返回空或报错，该检查什么？
User::select() 返回空数组，不一定是 SQL 错了，先看这三件事：
立即学习“PHP免费学习笔记（深入）”；
- 数据库连接是否成功？在模型里加个
public function testConn() { return $this->query('SELECT 1'); }，调一下看能不能执行原生语句 - 模型是否真被实例化？
var_dump(new User())看输出里有没有table属性，没有说明$table或自动推导失败 - 查询前有没有触发异常？开启调试模式后，
User::select()报错但没显示 SQL，大概率是模型初始化阶段出问题，比如initialize()方法里写了非法操作
模型不是黑盒，它本质就是个带数据库连接能力的对象。定义错一个属性，后面所有 save()、find()、where() 都可能静默失效——最麻烦的是不报错，只返回空。
