如何解析ThinkPHP中通过Composer安装扩展并实现vendor自动加载的过程？

本文共计960个文字，预计阅读时间需要4分钟。

ThinkPHP不自动加载，需要手动在入口文件（如public/index.php）中包含autoload.php。具体做法是添加以下代码：

常见错误现象：装了 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 根本不知道这个路径要扫。