TP 通过入口文件中 require DIR . '/../vendor/autoload.php' 引入 Composer 自动加载器；其 autoload 配置需在 composer.json 中声明 PSR-4 等规则并执行 dump-autoload 生效，与 TP 自带 Loader 并存但互不干扰。
Composer install 后 vendor/autoload.php 怎么被 TP 自动引入的？
ThinkPHP 不会“自动”加载 vendor/autoload.php，它靠的是你手动在入口文件（如 public/index.php）里那一行 require __DIR__ . '/../vendor/autoload.php';。没这句，Composer 装的扩展根本不会生效。
常见错误现象：装了 monolog/monolog，但 new MonologLogger 报错 Class not found —— 八成是入口文件漏了这行 require，或者路径写错了（比如少了个 ..）。
- ThinkPHP 6+ 默认入口已包含该 require；TP5.1 也默认有，但如果你用的是自己裁剪或老项目，务必检查
- 路径必须相对于当前入口文件，
__DIR__是关键，别硬写绝对路径 - 不要在控制器或中间件里重复 require —— Composer autoload 是全局单例，重复引入不报错但浪费
为什么 composer dump-autoload 有时没用？
不是所有类都能靠自动加载找到，关键看扩展有没有正确声明 autoload 字段，以及你是否用了 PSR-4 / classmap / files 等不同加载方式。
使用场景：你写了自定义类放在 app/common/Helper.php，加了命名空间但 use appcommonHelper 还是报错 —— 很可能是因为 Composer 根本不知道这个路径要扫。
立即学习“PHP免费学习笔记（深入）”；
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- TP 项目根目录的
composer.json中，"autoload": {"psr-4": {"app\": "app/"}}才能让appcommonHelper被识别 - 改完
composer.json后必须运行composer dump-autoload，否则缓存还是旧的 - 如果类没命名空间、或用
require手动加载，那它压根不走 Composer autoload，dump 也没用
think-swoole 或其他 TP 扩展启动时报 Class not found
这类扩展往往依赖特定版本的组件（比如 ext-swoole 或 symfony/console），而 Composer 加载顺序或版本冲突会让 autoloader 漏掉某些类。
典型表现：运行 php think swoole 直接报错，但 composer install 显示成功 —— 实际是 autoload_static.php 里没生成对应映射。
- 先确认扩展是否真装进
vendor/下对应目录（如vendor/topthink/think-swoole） - 运行
composer show topthink/think-swoole看实际安装版本，再核对文档要求的 TP 版本是否匹配 - 遇到混合使用
files和psr-4的扩展（如某些 SDK），务必清掉vendor/composer/autoload_*.php再dump-autoload -o
TP 自带的 Loader 和 Composer autoload 什么关系？
ThinkPHP 5.1+ 的 thinkLoader 已退居二线，只负责加载框架核心类（如 thinkApp）和 extend/ 目录下的手动注册类；Composer 管 vendor/ 里的第三方包，两者并存但互不干扰。
容易踩的坑：你在 extend/my/Test.php 里写了 namespace my;，又在 config/app.php 里配了 'extend' => ['my' => 'extend/my'] —— 这套逻辑和 Composer 完全无关，哪怕你删了 vendor，只要 Loader 配置对，它照样能 new 出来。
- Composer autoload 不读取 TP 的
extend或config/app.php - TP 的
Loader::addNamespace()是运行时行为，不能替代composer.json中的 autoload 声明 - 混用两种机制时，优先级是：Composer > TP Loader > 手动 require —— 但别指望它们自动合并命名空间
