ThinkPHP 不是普通 Composer 包，必须用 composer create-project topthink/think 初始化完整骨架，而非 require；因后者仅下载源码至 vendor，不生成 app/config/public 目录及执行初始化脚本，导致 Class 'thinkApp' not found 等错误。
直接说结论：ThinkPHP 不是普通 Composer 包，不能靠 composer require topthink/think 往已有项目里“加”，必须用 composer create-project 初始化完整骨架；后续扩展、自定义类加载、升级维护，全依赖 Composer 的正确配置和触发时机。
为什么 composer require topthink/think 会失败
它只下载框架源码到 vendor/topthink/think，不生成 app/、config/、public/index.php，也不执行 post-create-project-cmd 脚本（比如创建 runtime/ 目录、复制 .env.example）。结果就是：index.php 里 require __DIR__ . '/../vendor/autoload.php' 虽然能加载，但 App 类找不到、路由不生效、php think 命令直接报错。
- 常见错误现象：
Class 'thinkApp' not found、访问首页空白、Command "route:list" is not defined - 正确做法：在空目录下运行
composer create-project topthink/think myapp - 目标目录不能已存在，否则命令直接退出；脚本中建议加
--remove-vcs --no-interaction - 想指定版本？用
topthink/think:^8.0（允许小版本升级），别用8.0.*（语义不同）
vendor/autoload.php 不生效的 4 个硬坑
即使 create-project 成功，本地跑起来还是报类找不到，大概率卡在这几个地方：
-
index.php中require的路径写错，比如漏了../或混用反斜杠（Windows 下尤其容易出事） - 启用了 opcache 却没清：改完
composer.json或新增类后，必须调opcache_reset()或重启 PHP-FPM - Composer 2.5+ 默认跳过 scripts 钩子，导致 ThinkPHP 的自动引导逻辑（如生成类映射）被绕过；解决方法是在
composer.json的config节点加"allow-plugins": {"topthink/think-installer": true} - CLI 使用的
php.ini和 Web 服务器用的不是同一份（XAMPP/MAMP 常见），需单独确认 CLI 下mbstring、openssl、pdo是否启用：php -m | grep -E "mbstring|openssl|pdo"
装扩展包为什么 use thinkcaptchaCaptcha 还报错
因为 composer require topthink/think-captcha 只负责下载和自动加载注册，不等于服务就绪。TP6/8 扩展依赖服务提供者（Service Provider）机制，而它是否生效，取决于三件事：
立即学习“PHP免费学习笔记（深入）”；
- 检查
config/app.php的'providers'数组里有没有thinkcaptchaCaptchaService::class；没有就得手动加 - 确认
composer.json没写"dont-discover": ["*"]——这行会全局禁用所有包的自动注册，删掉或缩小范围 - 某些扩展（如
think-queue）要手动发布配置：cp vendor/topthink/think-queue/config/queue.php config/，否则初始化容器时直接崩 - 装完记得清缓存：
php think clear，否则旧的服务绑定还在内存里
自定义类怎么让 Composer 自动加载不丢
ThinkPHP 6 默认用 PSR-4，但你往 composer.json 的 "psr-4" 里加新命名空间时，路径映射必须严格匹配物理结构，且要手动刷新 autoload 缓存：
- 比如新增模块
app/common，就在"psr-4"里加："appcommon\": "app/common/"（注意双反斜杠转义） - 千万别动
"think\": "thinkphp/src/"这行，它是框架核心路径，改错会导致整个应用启动失败 - 改完必须运行
composer dump-autoload -o（-o表示优化，开发时也建议加，否则可能因缓存延迟找不到类） - 如果用了第三方 autoloader（如 Zend），要确认 TP 的 PSR-4 映射确实写进了
vendor/composer/autoload_psr4.php
最常被忽略的其实是环境一致性：CLI 的 PHP 配置、Web 服务器的 PHP 配置、Composer 版本、opcache 状态，这四者只要一个对不上，autoload 就可能时灵时不灵。调试时先跑 php -v、php -m、composer -V、opcache_get_status()，比瞎猜快得多。
