thinkphp自动加载由spl_autoload_register注册的多加载器协同完成，优先级为classmap→psr-4→psr-0，路径通过loader::addpsr4()或addclassmap()动态配置，且依赖composer dump-autoload更新映射。
ThinkPHP 的自动加载不是靠单一函数触发的，而是由 spl_autoload_register 注册的多个加载器协同完成，且优先级明确、路径可配置。手动 require 或 import 不是常态，真正起效的是运行时按规则逐层匹配的查找链。
自动加载从 base.php 开始注册
框架启动时，thinkphp/base.php 执行 Loader::register()，这一步做了三件事：调用 spl_autoload_register 注册主加载器；加载 Composer 生成的 autoload_static.php（含 PSR-4 映射）；再把 ThinkPHP 自己的命名空间（如 think、traits）通过 addPsr4() 注入到 Loader 内部映射表。注意：这个注册只发生一次，后续所有未定义类都走这个统一入口。
常见错误现象：Class 'thinkRequest' not found，往往是因为 Loader::register() 没执行（比如提前 exit 或异常中断），或 base.php 被跳过加载。
类查找顺序严格分三层：映射 → PSR-4 → PSR-0
当 PHP 遇到未定义类（如 new appcommonserviceUserService()），Loader 会依次尝试：
- 查
classMap：是否通过Loader::addClassMap()显式绑定过该类路径，命中则直接include_once，最快 - 查 PSR-4 映射：取类名前缀（如
app），在prefixDirsPsr4中找对应目录，再拼路径（app/common/service/UserService.php），文件存在即加载 - 查 PSR-0（已基本弃用）：兼容老项目，但 ThinkPHP 5+ 默认不启用，除非你手动加了规则
关键细节：PSR-4 匹配是“前缀最长匹配”，不是全等。例如 app 和 appcommon 同时注册时，appcommonserviceX 会优先走 appcommon 对应的目录，而不是 app 目录下找 common/service/X.php。
Composer 的 autoload 配置和 ThinkPHP 的 Loader 并存但互不覆盖
项目根目录的 composer.json 里写的 PSR-4 规则（如 "App\": "app/"），经 composer dump-autoload 后生成的 vendor/composer/autoload_static.php，会被 ThinkPHP 的 Loader 在 register() 阶段主动读取并合并进自己的映射表。所以你改了 composer.json 必须重新 dump，否则 Loader 不知道新路径。
容易踩的坑：
- 写错命名空间后缀：必须是
"App\": "app/"，漏掉末尾反斜杠，Loader 就无法识别前缀 - 路径写成绝对路径或带
./：Composer 只接受相对于项目根目录的路径，"app/"合法，"./app/"或"/var/www/app/"无效 - 误以为
app/目录默认被 autoload：ThinkPHP 自身不依赖 Composer 加载控制器/模型，app/下的类只有你显式配了 PSR-4 或加了 classMap 才能被 new 出来
自定义类路径要走 addPsr4 或 addClassMap，别碰 import
Loader::import() 是早期兼容方案，5.1+ 已移除，它不走自动加载流程，只是按字符串拼路径然后 include，无法支持命名空间解析，也绕过所有映射逻辑。现在加自定义路径唯一正解是：
- 对有规范命名空间的目录（如
extend/utils/下全是utils*类），用Loader::addPsr4('utils\', EXTEND_PATH . 'utils/') - 对单个高频类（如
extend/QrCode.php对应QrCode类），用Loader::addClassMap('QrCode', EXTEND_PATH . 'QrCode.php')
这两个方法必须在 Loader::register() 之后调用，否则新加的映射不会被加载器感知——最稳妥位置是 common.php 或应用初始化钩子中。
整个流程里最容易被忽略的点是：Loader 的映射表是运行时内存结构，不是静态配置文件；每次请求都重建，但 autoload_static.php 是 Composer 生成的固定快照，改完 composer.json 不运行 dump，Loader 就永远看不到新规则。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
