thinkphp 6+ 必须依赖 composer 自动加载，入口文件需先引入 vendor/autoload.php；自定义类须在 composer.json 中 psr-4 显式注册并执行 composer dump-autoload -o；第三方 sdk 应放 extend/ 目录并手动 require_once。
新手搭建 ThinkPHP 项目，最常卡在“类找不到”——不是代码写错了，而是自动加载没走通。核心就一条：ThinkPHP 6+ 完全依赖 Composer 的自动加载机制，不是“它支持 Composer”，而是“它必须靠 Composer 才能跑起来”。
入口文件必须先加载 vendor/autoload.php
ThinkPHP 启动的第一步，是让 PHP 知道去哪儿找类。这一步由 vendor/autoload.php 完成。它必须在框架初始化之前就被引入。
- 标准入口 public/index.php 已预置该语句：
require __DIR__ . '/../vendor/autoload.php'; - 如果你删过 vendor、迁移过项目、或从压缩包起步，这行极易被漏掉或路径写错（比如项目嵌套深了，
../应该改成../../） - 常见报错：
Fatal error: Uncaught Error: Class 'thinkApp' not found，基本就是这一步断了 - 切勿用
require_once多次引入 —— 类重复定义会直接崩溃
自定义类和工具类要走 PSR-4 显式注册
你写的工具类（比如 app/utils/ArrHelper.php），ThinkPHP 不会自动认，必须告诉 Composer：“这个命名空间对应这个目录”。
- 打开项目根目录的 composer.json，找到
"autoload": {"psr-4": {}}段 - 添加映射，格式严格：
"app\utils\": "app/utils/"（注意双反斜杠、末尾正斜杠） - 类文件名必须与类名完全一致且大小写敏感：类
ArrHelper→ 文件名必须是ArrHelper.php，不能是arrhelper.php - 改完配置后，终端执行：
composer dump-autoload -o（-o参数不可省，否则开发中常因缓存不更新而失效）
手动下载的 SDK（如百度 AIP、腾讯云 COS）怎么引
这类 SDK 通常没有 composer.json，也不遵循 PSR-4，不能指望自动加载。稳妥做法是放进 extend/ 目录并显式加载。
- 把 SDK 整个文件夹解压到
extend/aipbaidusdk/，确保AipNlp.php在该目录下 - 在控制器或服务中写：
require_once EXTEND_PATH . 'aipbaidusdk/AipNlp.php';（EXTEND_PATH是 TP6 内置常量） - 实例化无命名空间的类时，记得加反斜杠：
$client = new AipNlp(...); - 不要把这类 SDK 放进
vendor/或app/下——路径混乱会导致自动加载冲突
装了第三方包却 still class not found？重点排查这三处
运行 composer require guzzlehttp/guzzle 成功，但 new GuzzleHttpClient() 还报错？别急着重装，先看：
-
是否执行了
composer dump-autoload -o？尤其是改过composer.json或新增了类之后 -
vendor/autoload.php 是否真被引入？检查
public/index.php最顶部那行是否存在、路径是否有效 -
有没有同名目录干扰？例如装了
monolog/monolog，就别再建app/library/Monolog/—— TP 的 Loader 可能抢先匹配，跳过 Composer 加载
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
