class not found本质是psr-4自动加载失败，非文件缺失；需严格确保类文件路径、命名空间、composer.json配置及环境四者完全一致，并执行composer dump-autoload -o刷新映射。
类文件物理存在但提示“Class not found”，本质不是缺文件，而是自动加载机制没走通。ThinkPHP 6+ 完全依赖 Composer 的 PSR-4 自动加载，TP5 支持 Composer + 内置 Loader 双路径，而 TP3.2 主要靠 vendor() 和 import() 手动导入。排查必须从加载入口开始，逐层验证。
检查入口是否正确加载 autoload.php
ThinkPHP 6+ 启动前必须执行：
require __DIR__ . '/../vendor/autoload.php';
这行代码必须出现在 public/index.php 最顶部，且路径准确。项目结构嵌套变深（比如 public 在子目录下）、迁移后删过 vendor、或从压缩包解压起步时，极易漏掉或写错路径（如该写 ../../vendor/autoload.php 却写了 ../vendor/autoload.php）。
常见报错：Fatal error: Uncaught Error: Class 'thinkApp' not found，基本可锁定此处失败。
确认类文件位置、命名空间与目录结构三者严格一致
PSR-4 要求命名空间路径 = 目录路径，大小写完全敏感（Linux 服务器尤其关键）：
• 类定义 namespace appservice; → 文件必须存于 app/service/WechatService.php
• 类定义 namespace libqrcode; → 文件必须存于 extend/lib/qrcode/QrCode.php
• 文件名必须是 WechatService.php，不能是 wechatservice.php 或 WechatService.class.php（除非你用的是 TP3.2 且走 import）
若不一致，哪怕文件真实存在，Composer 也不会扫描它。
验证 composer.json 配置并刷新自动加载映射
新增类库目录（如 extend/ 或自定义目录）后，必须在项目根目录 composer.json 的 "autoload": {"psr-4": {}} 中显式注册："lib\": "extend/lib/""third\": "thirdparty/"
保存后立即执行：composer dump-autoload -o
不执行这步，Composer 就不知道新目录的存在。CI/CD 部署、本地改完配置未同步到线上、或用 composer install --no-dev --optimize-autoloader 时，都容易遗漏此操作。
区分版本选择正确的引入方式
• ThinkPHP 6.x：
– 必须走 Composer PSR-4；
– 第三方 SDK 若无 composer 包，放入 extend/ 并注册命名空间，再 new libQrCode()；
– 不支持 vendor() 和 import() 函数。
• ThinkPHP 5.x：
– 支持命名空间自动加载（推荐）；
– 也可用 import('qrcode', EXTEND_PATH) 或 Loader::import('wechat.sdk')；
– vendor() 仅用于 Library/Vendor/ 下的 .php 文件。
• ThinkPHP 3.2：
– 主要用 vendor('Zend.Filter.Dir') 导入 Library/Vendor/ 下文件；
– 实例化时加反斜杠：new Dir();；
– 类名需改为 类名.class.php，并补命名空间或手动 require。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
