ThinkPHP自动加载需严格匹配路径与命名空间：TP6+仅依赖Composer PSR-4，顺序由composer.json决定；TP5.x按类库映射、PSR-4、PSR-0三步检测。常见错误包括命名空间缺反斜杠、文件名大小写不符、未执行dump-autoload或未配置autoload路径。
ThinkPHP 自动加载不是“写完类就能用”，而是有一套明确的检测链条，顺序错了就找不到类。TP6+ 完全依赖 Composer 的 PSR-4 加载机制，不再走老版本的 Loader::addNamespace() 或 import()；TP5.x 则仍保留多层检测逻辑，但两者都遵循“先匹配、先生效、不继续”的原则。
TP6+：只走 Composer PSR-4，顺序由 composer.json 决定
TP6+ 的自动加载本质就是 Composer 的自动加载器在工作，框架自身不干预路径查找。所谓“顺序”，实际是 Composer 内部的加载策略：
- PSR-4 映射优先匹配（命名空间前缀 + 目录路径必须严格对齐，比如
"app\": "app/"） - 匹配失败后，才 fallback 到 PSR-0（极少用）、classmap（需手动
composer dump-autoload -o生成）、files（全局引入） - Composer 不会去扫描
extend/或runtime/目录，除非你显式加到composer.json的 autoload 配置里 - 常见错误：
Class "appcontrollerIndex" not found—— 说明命名空间写成了appcontroller（缺反斜杠），正确应为appcontroller，且文件路径必须是app/controller/Index.php
TP5.x：三段式检测，类库映射优先于 PSR-4
TP5.x 的自动加载仍由框架 Loader 类驱动，检测顺序固定，且可被人工干预：
- 第一步：类库映射（
Loader::addClassMap()）—— 最快，直接跳过路径推导，适合高频使用的类，如thinkLog - 第二步：PSR-4 自动加载 —— 要求命名空间与目录结构一致，例如
orgutilArray对应org/util/Array.php - 第三步：PSR-0 回退兼容 —— 基本不用，仅用于极老风格的下划线命名类（如
Org_Util_Array） -
import()函数已被移除，别在 TP5.1+ 里用；它曾按“当前模块 → extend → 其他模块”找类，但逻辑模糊、性能差、易冲突
为什么类明明存在却报 “Class not found”？
这不是加载顺序问题，而是路径或声明没对上。重点检查以下几点：
立即学习“PHP免费学习笔记（深入）”；
- 类文件名是否与类名完全一致（大小写敏感）：如类
Index，文件必须叫Index.php，不能是index.php或Index.PHP - 命名空间声明是否带末尾反斜杠：
namespace appcontroller;✅，namespace appcontroller❌（少分号不算，少反斜杠是硬伤） - TP6+ 是否执行过
composer dump-autoload -o？改了composer.json或新增类后，这步必须做，否则新映射不生效 - TP5.x 是否把
addClassMap()放在了common.php或start.php里？放错位置（比如控制器里）会导致映射注册失败
最常被忽略的是：TP6+ 的 app/ 目录默认不在 Composer 自动加载范围内，你写了 appserviceUserService，却不往 composer.json 里加 "app\": "app/"，那就永远找不到——框架不会替你猜路径，它只忠实地执行你配的规则。
