必须先创建user模型类，否则查询报“class not found”；需确认database.php中hostname、username、password、database四项齐全且可连通；用db::query('select 1')测试连通性；模型文件须严格按命名空间app\model、继承think\model书写；推荐用php think make:model app\model\user命令生成；验证时用user::find(1)并确保id=1存在且主键名$pk与数据库一致。
刚配好ThinkPHP环境，数据库已建好user表，现在要让代码能读写这张表——必须先创建对应的数据模型，否则连最基础的查询都会报错“Class not found”。
确认数据库配置是否生效
打开项目根目录下的 config/database.php，检查 【'hostname'、'username'、'password'、'database' 四项必须全部填写且能连通】。漏填任一字段会导致后续所有模型操作抛出 PDOException，且错误提示不明确。
在任意控制器中写一行测试代码：dump(\think\facade\Db::query('SELECT 1')); 。若返回 [1] 数组，说明数据库已通；若报错“Connection refused”，立刻回头检查 host 和端口。
手动创建模型文件
在 app/model/ 目录下新建 User.php 文件（注意：不是 UserModel.php，也不是 Users.php）。
文件内容严格按以下结构书写：
<?php <br>namespace app\model;<br>use think\Model;<br>class User extends Model<br>{<br> // 若数据表名为 `tp_user` 或 `myapp_user`，取消下面这行注释并修改为实际表名<br> // protected $table = 'tp_user';<br>}
这一步不能跳过命名空间和继承声明，缺任何一项都会导致 【类自动加载失败，报 Class 'app\model\User' not found】。
命令行快速生成模型（推荐）
打开终端，cd 进入项目根目录（含 think 可执行文件的位置）。
执行命令：php think make:model app\model\User。
该命令会自动生成带命名空间、继承 Model、且已预置常见属性（如 $table、$pk）的 PHP 文件，路径为 app/model/User.php。比手写少犯三类错误：命名空间拼错、use 语句漏写、class 声明格式不规范。
如果提示 “Command 'make:model' is not defined”，说明你用的是 ThinkPHP 5.0 以下版本或未启用 think 命令行组件——此时必须退回手动创建。
验证模型能否正确实例化
第一步：在控制器方法中添加以下代码
use app\model\User;<br>$user = User::find(1);<br>dump($user);
第二步：确保 user 表中 id=1 的记录真实存在。若表为空，find(1) 返回 null，容易误判为模型无效。
第三步：浏览器访问该控制器方法。看到输出一个 User 对象（非 null），且包含 id、name 等字段值，说明模型已成功绑定数据表并可执行查询。
如果 dump 输出为 null 但数据库里确有 id=1 的数据，请立即检查模型类中是否误写了 protected $pk = 'uid'; ——主键名必须与数据库实际主键字段名完全一致，包括大小写。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
