核心原因是自动加载机制未识别类，需严格匹配命名空间、路径与框架版本规范：tp5.1+及tp6强制依赖composer psr-4，extend目录不自动扫描，须在composer.json中配置autoload并执行composer dump-autoload -o。
ThinkPHP 引入第三方类库报 “Class not found”（未定义类），核心原因是自动加载机制没识别到该类。不是文件放对了就一定能用，关键要看命名空间、路径、加载方式是否匹配框架当前版本的规范。
确认 ThinkPHP 版本对应加载规则
不同版本差异很大，不能混用方法：
-
TP3.2/5.0：支持
Vendor()、Loader::import()、手动require_once，也允许把类放在ThinkPHP/Library/Org/或应用目录下的自定义路径；类名需为XXX.class.php，且建议补全命名空间 -
TP5.1+：默认依赖 Composer PSR-4 自动加载，
extend/目录不再被自动扫描；若 SDK 没走composer require安装，必须在composer.json中显式配置 autoload（PSR-4 或 files），再执行composer dump-autoload -o -
TP6.x：强制要求 Composer 加载，入口文件必须先引入
vendor/autoload.php；extend/仅作存放用途，不参与自动加载，需手动require_once或通过Loader::addNamespace()注册命名空间
检查命名空间与文件路径是否严格一致
尤其在 TP5/6 中，PSR-4 规范要求“命名空间 = 目录结构”，一个字母或层级错都会加载失败：
- 若类定义为
namespace alipay\service;，则文件必须放在extend/alipay/service/AliPayService.php - 类名大小写必须和文件名、
new实例化时完全一致（Linux 环境下尤其敏感） - 使用命名空间时，实例化要加反斜杠：
$pay = new \alipay\service\AliPayService();，或先use alipay\service\AliPayService;再new AliPayService()
绕过自动加载的手动引入方案
适合临时调试或无法修改 composer.json 的场景：
- TP3.2/5.0：用
Vendor('Alipay.AopSdk');（对应Vendor/Alipay/AopSdk.php），然后$aop = new \AopClient();（注意开头的\） - TP5.1+/6.x：直接
require_once EXTEND_PATH . 'alipay/AopClient.php';，再$aop = new \AopClient(); - 统一推荐方式：在控制器或服务类开头加
Loader::addNamespace('alipay', EXTEND_PATH . 'alipay');，之后就能用use alipay\AopClient;正常引用
验证是否真被加载成功
别只看文件存在，要确认 PHP 真的读进来了：
- 在报错前加一行
var_dump(class_exists('YourClassName'));，输出false就说明没加载 - 运行
composer show查看 SDK 是否已安装；若只是拖文件进extend/，composer show不会显示它 - 检查
vendor/composer/autoload_psr4.php，确认你的命名空间映射是否存在
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
