ThinkPHP引入第三方类库出错的核心原因是PSR-4自动加载未配置成功：路径、命名空间、composer.json配置三者必须严格一致，extend目录不被默认扫描，需手动配置autoload或注册命名空间。
ThinkPHP 引入第三方类库出错，核心原因就一个：自动加载没走通。不是文件放错了位置，而是框架根本“没看见”这个类——它不知道该去哪找、用什么命名空间调用。
Class not found：路径、命名空间、配置三者必须严丝合缝
这是最常见报错，尤其在 Linux 服务器上一部署就崩。ThinkPHP 6+ 完全依赖 PSR-4 自动加载，任何一处不一致都会失败：
- 文件路径必须和命名空间完全对应，比如 namespace WeChatService; 就必须放在 extend/wechat/src/Service/xxx.php，不能多一层、少一层，也不能大小写错（
Wechat≠wechat） -
composer.json中的 PSR-4 配置必须显式声明，例如："WeChat\": "extend/wechat/src/" - 改完配置后，一定要执行
composer dump-autoload -o，只清缓存或重启服务没用
SDK 放对地方≠能用：extend/ 目录不会被自动扫描
很多人把 SDK 往 extend/ 一丢就以为万事大吉，但 ThinkPHP 默认只加载 app/ 和 vendor/ 下符合 PSR-4 的类。extend/ 只是个约定存放地，不是自动加载源。
- 若 SDK 没通过
composer require安装，又没在composer.json里配 autoload，Composer 就完全忽略它 - 临时解决：在
public/index.php中框架初始化前手动注册命名空间：thinkLoader::addNamespace('WeChat', __DIR__ . '/../extend/wechat/src'); - 不推荐做法：在控制器里写
require_once './extend/xxx.php'—— 破坏自动加载逻辑，IDE 无法识别，类型提示失效
老项目迁移或手动引入时的坑
TP 5.1+ 已废弃 import() 和 Vendor() 助手函数，这些在新版本中直接报错或静默失败。
立即学习“PHP免费学习笔记（深入）”；
- TP 3.2/5.0 的写法如
Vendor('PHPExcel.Classes.PHPExcel')在 TP 6+ 不再支持 - 如果 SDK 没命名空间（比如纯函数库或老版 PHPExcel），要用
"files"方式加载："autoload": { "files": ["extend/alipay/aop/AopClient.php"] } - 引用时注意加反斜杠：
$excel = new PHPExcel();，漏掉会去当前命名空间下找，必然失败
调试建议：别猜，先验证基础链路
遇到类找不到，按顺序快速验证这四点，80% 的问题当场定位：
- 入口文件是否已加载
vendor/autoload.php？路径是否正确（嵌套深了要改../层数）？ - 报错类的命名空间声明是否与文件物理路径完全一致？包括大小写、斜杠方向、末尾是否多/少斜杠
-
composer.json的autoload段是否包含该 SDK？格式是否合法（冒号后有空格、引号闭合）？ - 是否执行过
composer dump-autoload -o？有没有权限问题导致生成失败？
