“class not found”不是文件丢失，而是自动加载失败；主因是命名空间、路径、composer autoload配置三者未严格一致，新增类后须执行composer dump-autoload -o刷新映射。
“Class not found”不是文件丢了，而是自动加载没走通——90% 的情况跟文件是否存在无关，只跟命名空间、路径、autoload 配置这三者是否对得上有关。
类在 extend/ 目录下却报找不到
ThinkPHP 5 不会自动扫描 extend/ 下的类，必须满足两个条件之一才能被识别：
- 类文件的命名空间要严格匹配目录结构，比如
extend/lib/MyClass.php必须声明namespace lib;，且类名为MyClass - 如果不想改命名空间，就用
Loader::import()手动引入：Loader::import('lib.MyClass', EXTEND_PATH);（注意路径分隔符是点号） - 别漏掉
composer.json里的 PSR-4 映射：如果想让 Composer 管理extend/下的类，得显式加一条："lib\": "extend/lib/"，然后执行composer dump-autoload
vendor/ 里的第三方类（如 PHPExcel）提示 PHPExcel_IOFactory not found
这类问题几乎全是命名空间前缀或加载方式不对：
-
PHPExcel_IOFactory开头的反斜杠不能少，漏了就是相对命名空间，PHP 会去当前命名空间下找，自然失败 - 不要用
require_once+PHPExcel.php这种老式写法，它绕过了自动加载，也破坏了类依赖关系 - 推荐做法：把 PHPExcel 放进
vendor/后，在composer.json中加 autoload 映射，再跑composer dump-autoload；若实在要用extend/，则必须用Loader::import()或vendor()助手函数 - 常见错误：写成
PHPExcel_IOFactory::createReader()（缺反斜杠），或use PHPExcel_IOFactory（没写反斜杠也没用）
明明文件存在、命名空间也对，还是 Class not found
这时候大概率是环境或缓存层面的问题：
- Linux 服务器区分大小写：
IndexController.php≠indexcontroller.php，IDE 在 Windows 上不报错，部署到 Linux 就崩 -
runtime/classmap.php缓存可能过期或损坏，删掉runtime/目录重新访问一次，框架会重建 - 修改了
composer.json但没运行composer dump-autoload，Composer 根本不知道新类在哪 - 用了
Loader::addNamespace()动态注册命名空间，但该调用写在了中间件或控制器里——时机太晚，自动加载已经初始化完了
接口注入时提示实现类找不到
ThinkPHP 容器不会自动发现哪个类实现了某个接口，必须显式绑定：
- 绑定语句必须写全限定名：
App::bind(ppcontractUserRepositoryInterface::class, pp epositoryDbUserRepository::class) - 绑定位置很重要：子应用（如
admin/）要用自己目录下的provider.php，全局app/provider.php对子应用无效 - 检查实现类是否真
implements了接口，IDE 补全有时会漏掉，手动核对类定义顶部那行 - 别在构造函数里直接
new控制器，那样容器根本没参与，类型提示纯属摆设；确保路由指向的是方法（如'index/user/index'），而不是你手动new Index()
最常被忽略的一点：base.php 缺失会导致整个自动加载机制失效，但错误信息未必直接暴露这点。如果连 App 类都找不到，先确认 thinkphp/base.php 是否真实存在且可读——其他所有排查都建立在这个前提之上。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
