Class not found错误本质是自动加载失败，需检查vendor完整性、框架版本是否为5.1.x、composer autoload配置是否正确、第三方扩展是否通过composer安装、PHP扩展（如fileinfo、PDO）是否启用，以及Web根目录是否指向public/。
Class not found 错误在 ThinkPHP5 中基本不是代码写错了，而是自动加载没通——要么类根本没装进来，要么路径/命名空间对不上，要么 PHP 扩展缺位。
检查 vendor 是否完整、框架版本是否匹配
运行 php think version，如果报 Class 'thinkApp' not found，说明 vendor/autoload.php 没被引入，或 topthink/framework 根本没装成功。
- 确认项目根目录存在
think（Linux/macOS）或think.bat（Windows），没有就代表框架命令行入口缺失 - 执行
composer show topthink/framework，输出必须是5.1.x形式；若显示6.0.0或更高，说明误装了 TP6，得删掉vendor和composer.lock，再重装：composer require topthink/framework:^5.1 --update-with-dependencies - 检查
composer.json里"topthink/framework"的版本约束是不是写成了^6.0或dev-master
第三方扩展类（如 Image、Captcha、Db）找不到的典型原因
这类错误往往不是“类不存在”，而是它没进 Composer 的自动加载映射表，或者被放到了 TP 不扫描的目录。
-
thinkImage报错：别手动移动./vendor/topthink/think-image/src到./thinkphp/library/think—— 这是旧方案，TP5.1+ 应该用composer require topthink/think-image安装，然后确保vendor/composer/autoload_psr4.php里有'think\image\' => array($vendorDir . '/topthink/think-image/src') -
thinkcaptchaCaptcha找不到：必须执行composer require topthink/think-captcha 2.*（TP5.1 对应 2.x 版本），不能只把文件丢进extend/；安装后检查autoload_psr4.php是否已注册think\captcha\命名空间 -
thinkDb报错：TP5.1 中正确写法是use thinkDb;，不是use think acadeDb;（那是 TP6 的）；若用了旧写法thinkDb::name()，会直接失败
PHP 环境或扩展缺失导致的“假 Class not found”
有些类依赖底层 PHP 扩展，扩展没开，new 时就会报“类未定义”，其实是扩展类根本没注册进 PHP 内核。
立即学习“PHP免费学习笔记（深入）”；
-
Class 'finfo'找不到：运行php -m | grep fileinfo，没输出就说明fileinfo扩展未启用，需在php.ini加extension=fileinfo.so（Linux）或extension=php_fileinfo.dll（Windows），然后重启 Web 服务 -
Class 'PDO'或Class 'Redis'报错：同理，检查php -m输出，确认对应扩展已加载；TP5 连接数据库前会尝试实例化这些类，缺一个就卡住 - Linux 部署时访问 404/500 伴随 Class not found：先确认 Web 根目录是否指向
public/，否则index.php不执行，自动加载机制压根不启动
手动加载类时最容易忽略的路径与时机问题
有人把 SDK 放进 extend/ 后写 require_once './extend/sdk/xxx.php'，能跑但隐患极大。
-
extend/目录本身不参与 Composer 自动加载，也不被 TP 默认扫描——它只是个约定存放地 - 若必须用
extend/，要在public/index.php中 TP 初始化前调用：thinkLoader::addNamespace('WeChat', __DIR__ . '/../extend/wechat/src');，且类文件里的namespace必须和这个路径严格一致（比如extend/wechat/src/Pay.php必须声明namespace WeChat;） - 不要在控制器里用
require_once或include加载类——破坏 PSR-4，IDE 无法跳转，类型提示失效，后续升级难定位
真正麻烦的不是报错本身，而是错误信息掩盖了真实断点：你以为是类名写错了，其实可能是 composer dump-autoload 没跑、fileinfo 没开、或者 public/ 根目录设错了。每次遇到先看 php think version 和 php -m，比翻代码快得多。
