ThinkPHP自动加载依赖spl_autoload_register与PSR-4规范，按命名空间映射路径按需加载；须配置composer.json、执行composer dump-autoload -o，并确保入口引入vendor/autoload.php。
ThinkPHP 的自动加载不是靠“扫描文件”实现的，而是依赖 PHP 的 spl_autoload_register 机制，配合命名空间、目录结构与映射配置，按需加载类文件。核心在于“声明即可用”，而不是“存在就加载”。
PSR-4 是主干逻辑：命名空间必须严格对应路径
ThinkPHP 5.1+ 和 6.x 默认遵循 PSR-4 规范。系统根据类的完整命名空间（如 appcontrollerIndexController），推导出应加载的文件路径：
- 顶级命名空间
app必须在composer.json中明确映射到app/目录，例如："psr-4": {"app\": "app/"} - 类名
IndexController对应文件名IndexController.php，且必须放在app/controller/下（不能是app/controller/v1/，除非额外注册子映射） - 大小写敏感：Linux 服务器上
app/controller/indexcontroller.php不会被appcontrollerIndexController加载
Composer autoload 是基础，不是可选项
ThinkPHP 自身不解析文件系统来发现类，它依赖 Composer 生成的自动加载逻辑：
- 入口文件（如
public/index.php）中必须有require __DIR__.'/../vendor/autoload.php'; - 新增或移动控制器、模型等类后，必须运行
composer dump-autoload -o更新映射 - 检查
vendor/composer/autoload_psr4.php是否已包含你的命名空间映射，这是最直接的验证方式 - 若使用多应用模式（如
app/admin），需在composer.json中为每个应用单独声明 PSR-4 映射
框架 Loader 是补充，不是主力
ThinkPHP 自带的 hinkLoader 在现代版本中已退居辅助角色：
立即学习“PHP免费学习笔记（深入）”；
- 主要负责加载框架核心类（如
hinkApp）、extend/目录下的扩展类，以及处理类库别名（如Db→hinkDb） - 它不会替代 Composer 加载你写的业务类；如果你的控制器报 “Class not found”，问题几乎一定出在 Composer 映射未生效，而非 Loader 配置
-
Loader::register()会注册自己的autoload方法，但优先级低于 Composer 的加载器，且只在 PSR-4/PSR-0 匹配失败后才介入
常见失效场景与快速排查
当类找不到时，按顺序检查以下四点，90% 的问题可定位：
- 命名空间声明是否与路径完全一致（末尾无多余
Controller、无拼写错误、无大小写混淆） -
composer.json中的 PSR-4 映射是否覆盖该命名空间，路径是否正确（用__DIR__计算相对路径） - 是否执行过
composer dump-autoload -o，且vendor/composer/autoload_psr4.php已更新 - 入口文件是否确实引入了
vendor/autoload.php，路径有没有写错（比如少了一个..）
