model类不能通过autoload.php的$libraries或$helpers自动加载；正确方式是用model()辅助函数、构造函数绑定或依赖注入，且必须继承codeigniter\model并确保psr-4路径正确。
Model 类在 CodeIgniter 4 中不能通过 Autoload.php 的 $libraries 或 $helpers 配置项自动加载——这是最常被误解的一点。CI4 的模型设计为按需实例化，框架不提供“全局自动加载所有模型”的机制，强行配置反而会报错或失效。
Autoload.php 里加 model 名字没用
-
app/Config/Autoload.php中的$psr4和$classmap只负责类文件的自动定位与包含（即 PHP 的spl_autoload_register行为），不是“自动 new 实例”。 -
$libraries数组只对Services管理的库生效（如session、database），Model不在此列。 - 如果你在
$libraries里写'UserModel'，启动时会抛出Class 'App\Libraries\UserModel' not found，因为 CI 会默认去App\Libraries\下找，而非App\Models\。
正确初始化模型的三种方式
-
直接在控制器中用
model()辅助函数：$users = model('UserModel'); // 返回已实例化的 UserModel 对象它会自动检测命名空间、调用Services::model()，并注入数据库连接（如果继承了CodeIgniter\Model）。 -
在控制器构造函数中提前绑定：
protected $users;
public function __construct()<br>{<br> $this->users = model('UserModel');<br>}这样后续方法可直接用$this->users->find()。 -
使用依赖注入（仅限继承
CodeIgniter\Controller的控制器）：public function index(UserModel $userModel)<br>{<br> $data = $userModel->findAll();<br>}前提是该模型已注册进Services（默认已支持），且路由未禁用 DI。
容易踩的坑
- 模型类没继承
CodeIgniter\Model：会导致model()返回的对象没有find()、insert()等方法，只是个空壳。 - 命名空间路径不匹配：例如类声明为
namespace App\Models;，但Autoload.php中$psr4['App'] = APPPATH . 'Models/';写成了APPPATH . 'models/'（大小写敏感，Linux 下直接失败）。 - 手动
new UserModel()而不传 DB 实例：会触发Call to a member function query() on null，因为基类的$db属性未初始化。 - 在
BaseController构造函数中调用model()后赋给$this->model，但子类同名属性会覆盖它（PHP 属性不继承），导致子类里访问不到。
CI4 的模型加载逻辑依赖于 Services::model() 工厂和 PSR-4 自动加载协同工作。跳过工厂直接 new，或试图用旧版 CI3 的 autoload 思路套用，都会卡在实例化或依赖注入环节。真正要“省事”，就老实用 model('XxxModel') —— 它内部已处理命名空间解析、DB 注入、单例复用，比手动管理更可靠。
