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 生成的自动加载逻辑：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

• 入口文件（如 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 在现代版本中已退居辅助角色：

• 主要负责加载框架核心类（如 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，路径有没有写错（比如少了一个 ..）

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！