ThinkPHP类找不到主因是自动加载机制未生效：TP6+必须通过composer.json配置PSR-4并执行composer dump-autoload -o，入口文件须正确引入vendor/autoload.php；TP5支持命名空间自动加载或Loader::import；TP3.2依赖import/Vendor函数。
类找不到，八成不是代码问题，而是加载路径或机制没对上。ThinkPHP 不同版本差异大，得先分清是 TP3.2、TP5 还是 TP6+，再按对应方式处理。
TP6+ 必须走 Composer 自动加载
TP6 起彻底依赖 Composer，vendor/autoload.php 是启动前提：
- 入口文件 public/index.php 必须有 require __DIR__ . '/../vendor/autoload.php';，缺了或路径写错（比如多一层嵌套却没加 ../）就会报 Class not found
- 你自己写的工具类（如 app/utils/Helper.php），不能靠“放对位置就自动认”，必须在 composer.json 的 autoload → psr-4 里显式注册命名空间和路径，改完要执行 composer dump-autoload -o
- 第三方 SDK（如微信 PHP 版、阿里云 OSS SDK）推荐用 composer require 安装；若手动放 extend/ 目录，则需 require_once 显式引入，不能指望自动加载
TP5 支持多种加载方式，优先选命名空间
TP5 默认启用 PSR-4 自动加载，只要结构对、命名空间对，就能直接 new：
- 把类库放进 extend/ 目录，比如 extend/wechat/WeChat.php，类定义 namespace wechat;，就能直接 new \wechat\WeChat() 或 use wechat\WeChat; new WeChat()
- 如果类没命名空间（比如老版 PHPExcel），不能用 new \PHPExcel()，得用 Loader::import('PHPExcel.Classes.PHPExcel', VENDOR_PATH) 或助手函数 import('PHPExcel.Classes.PHPExcel', VENDOR_PATH)，实例化时加反斜杠：new \PHPExcel()
- 避免混用：不要一边写 use，一边又用 import；也不要对同一个类既 autoload 又 require_once，容易重复定义报错
TP3.2 主要用 import 和 vendor 函数
TP3.2 没有统一命名空间机制，靠约定路径和函数导入：
立即学习“PHP免费学习笔记（深入）”；
- 符合规范的类（如 ThinkPHP/Library/Org/Util/Array.class.php），可直接 import('Org.Util.Array')，然后 new \Org\Util\Array()
- 放在 Vendor/ 目录下的 .php 文件（如 Vendor/Phpqrcode/phpqrcode.php），用 Vendor('Phpqrcode.phpqrcode')，注意大小写敏感，实例化是 new \phpqrcode()
- 纯函数文件（无 class）、或路径不标准的，直接 include_once 或 require_once 绝对路径，但别写相对路径如 ../../../，容易因调用位置不同而失败
通用排查步骤
不管哪个版本，先做这三件事：
- 确认类文件真实存在，路径和大小写完全匹配（Linux 下 Vendor 和 vendor 不是一回事）
- 检查类定义是否有 namespace，有就看是否和目录结构一致；没有就别用 use，实例化时必须加 \
- 打开 PHP 错误报告，看报错是 Class 'xxx' not found 还是 Cannot redeclare class——前者是没加载，后者是重复加载
