ThinkPHP 依赖 Composer 自动加载机制，入口文件必须正确引入 vendor/autoload.php，否则所有类（含核心类）均报 Class not found；标准入口 public/index.php 已预置该语句，路径错误、删改 vendor 或未执行 composer dump-autoload -o 均会导致加载失败。
ThinkPHP 本身不“加载” Composer 依赖，而是靠你确保 vendor/autoload.php 被正确引入 —— 漏了这一步，所有 Composer 安装的类（包括 ThinkPHP 自己的核心类）都会报 Class not found。
入口文件必须 require vendor/autoload.php
ThinkPHP 6/7 的标准入口是 public/index.php，它默认已包含：
require __DIR__ . '/../vendor/autoload.php';
但如果你删过 vendor、换过项目结构、或从 ZIP 包起步，这行很可能被删掉或路径写错。常见错误现象：
Fatal error: Uncaught Error: Class 'thinkApp' not found- 控制器里
use think db报错，但composer show topthink/framework显示已安装
检查点：
立即学习“PHP免费学习笔记（深入）”；
- 确认
vendor/autoload.php文件真实存在（不是空目录） - 路径是否因项目根目录移动而失效？比如项目放在
/var/www/myapp，但入口里写的是../vendor/autoload.php，实际应为../../vendor/autoload.php - 别用
require_once多次引入 ——Cannot declare class很可能源于此
autoload 配置改错会导致自定义类失效
你在 composer.json 里加了 "appservice": "app/service/"，但控制器还是找不到 appserviceUserService？问题大概率出在 autoload 配置或执行漏步。
ThinkPHP 6+ 默认只自动加载 app 下的控制器、模型等，但自定义命名空间必须显式声明并触发重生成：
- 修改
composer.json的"psr-4"段后，**必须运行**composer dump-autoload -o（-o不可省，否则开发环境常因缓存不更新而失效） - 目录名和命名空间大小写要完全一致：
app/Service/对应"appService": "app/Service/"，不能写成service小写 - 别动框架自带的
"think": "thinkphp/src/"行 —— 改错直接导致thinkApp找不到
第三方扩展没注册服务提供者就等于没装
composer require topthink/think-swoole 成功后，php think swoole 还报 command not found？说明服务提供者没生效。
ThinkPHP 6+ 的扩展包（如 think-swoole、think-queue）依赖服务提供者自动注册，但有两个前提：
- 包本身带
think-service声明（查vendor/topthink/think-swoole/composer.json是否有"extra": {"think-service": "think\service\SwooleService"}） - 你的项目
config/app.php中'providers'数组里必须包含该服务类，例如：thinkserviceSwooleService::class - 如果扩展没自动追加，就得手动加 ——
composer require不会帮你改配置文件
注意：有些包（如 overtrue/wechat）纯工具库，没服务提供者，直接 use 就行；但带命令、中间件、事件监听的扩展，跳过注册就白装。
部署时删了 vendor 或跳过 autoload 优化会出事
线上部署为了提速，有人删 vendor/composer/autoload_*.php 或注释掉 vendor/autoload.php 引入 —— 这会让整个自动加载链断裂。
正确做法是：
- 生产环境用
composer install --optimize-autoloader --no-dev，它会生成优化后的autoload_static.php，比默认加载快 20%~30% -
vendor/目录绝不能删、不能 git 提交、不能挪位置 ——thinkinitializerLoader硬编码读取vendor/autoload.php - 别在
.env或部署脚本里设COMPOSER_VENDOR_DIR—— ThinkPHP 不读这个环境变量，改了等于白改
最易被忽略的一点：CI/CD 流水线里如果用了 composer install 但没带 --no-dev，开发依赖（如 phpunit）会混进线上环境，既增大体积又可能引发安全扫描告警。
