90%的模型类报错源于命名与路径不一致：类名User、文件名User.php、命名空间appmodel、路径app/model/User.php必须严丝合缝；use语句不可遗漏；表名推导失败时才手动设$table等属性。
模型类文件找不到、User::select() 返回空、Class not found 报错——90% 是命名或路径没对上，不是代码逻辑问题。
模型类名和文件路径必须三者完全一致
ThinkPHP 8 使用 PSR-4 自动加载，不靠配置、不靠注释，只认三件事是否严丝合缝：
- 类名是
User，文件名就必须是User.php（不能是user.php、UserModel.php或userModel.php） - 命名空间必须是
appmodel（小写model，不是Model或appModel） - 文件路径必须是
app/model/User.php（正斜杠，Windows 下也不能用反斜杠）
控制器里使用前，use appmodelUser; 这句不能漏；漏了 PHP 就会在当前命名空间下找 User，直接报错。
表名自动推导规则与破例时机
框架默认把类名转成小写下划线格式，并拼上前缀（如配置中 prefix => 'think_'）：
立即学习“PHP免费学习笔记（深入）”；
-
User→think_user -
UserProfile→think_user_profile
这个转换不看数据库实际表名，也不读注释。一旦失败，就得手动设：
PHP 8.5.12 RC 1
下载
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
-
$table = 'UserInfo'：表名含大写字母、带数字、或根本不符合驼峰转下划线规则时必须设 -
$pk = 'uid'：主键字段不是id，否则find(1)、save()全部失效 -
$name = 'customer'：类叫Member却要查customer表，且不能/不想改类名时才设
注意：$table 一设，就绕过全局 prefix 配置，该模型不再受 database.php 里 prefix 影响。
为什么 new User() 没反应或报错？先别改模型代码
绝大多数情况，不是模型类写错了，而是加载链断在更底层：
- 检查
composer.json中是否保留了"psr-4": {"app\": "app/"}（ThinkPHP 默认有，但改过自动加载配置就可能被删） - 运行
composer dump-autoload强制刷新映射，别信缓存 - 确认
app/model/User.php文件权限可读，且没有 BOM 头（尤其 Windows 编辑器保存时容易带）
常见错误现象：User::get(1) 报 Class 'User' not found，或返回空数组却不报错——基本就是这三处之一出问题。
模型定义本身只需继承 thinkModel
最简模型代码只有四行，不需要任何额外配置：
<?php
namespace appmodel;
use thinkModel;
class User extends Model
{
}
别加 protected $table 或 protected $pk，除非你明确知道它和默认规则不匹配。多写反而容易覆盖掉正确推导，尤其是 $table 会直接屏蔽前缀配置，后续换库或统一改前缀时容易踩坑。
