应使用composer create-project topthink/think myapp初始化ThinkPHP项目，因其自动构建完整骨架（含app/、config/、public/等目录）并执行初始化脚本；require仅拉代码不建结构，导致Class 'thinkApp' not found等错误。
直接用 composer create-project 初始化项目，别手动 require 或下载 ZIP 包——否则 90% 的 “Class not found” 都由此而来。
为什么 composer require topthink/think 会失败
这不是 ThinkPHP 的正确引入方式。topthink/think 是完整应用骨架（含 public/、app/、config/ 等目录），不是纯库包。用 require 只拉取代码，不执行初始化脚本，缺失 runtime/ 目录、基础配置和入口文件。
- 错误现象：
Class 'thinkApp' not found、访问首页 404、php think run报错命令未定义 - 正确做法：运行
composer create-project topthink/think myapp，让 Composer 自动构建标准结构 - 若需指定版本（如 TP 6.1 LTS），写成
composer create-project "topthink/think:^6.1" myapp - Windows 用户注意：命令行当前路径必须是父级目录（如
D:www），不能是空文件夹内再cd myapp—— 否则public/index.php中的require __DIR__ . '/../vendor/autoload.php'会因相对路径失效
vendor/autoload.php 没被加载的典型原因
ThinkPHP 一切类加载都依赖这一个文件。它没生效，整个自动加载链就断了。
- 入口文件（
public/index.php）里漏了require __DIR__ . '/../vendor/autoload.php';—— 检查这一行是否存在且路径没错（特别注意../） - PHP CLI 和 Web 使用的
php.ini不同：Windows 下 XAMPP/MAMP 常见此问题，php -m | grep openssl在命令行能过，但 Apache 下报错，说明 Web 环境缺扩展 - 启用了
opcache却没清缓存：改完composer.json或删过vendor/后，必须调用opcache_reset()或重启 PHP-FPM，否则旧类映射仍在内存中 - Linux 下大小写敏感：类名
AppServiceUser对应文件必须是app/service/User.php，写成user.php就加载失败
添加扩展时 composer require 怎么写才安全
ThinkPHP 官方扩展（如 topthink/think-swoole）和第三方包（如 guzzlehttp/guzzle）都走 Composer，但约束不写清楚，升级就翻车。
立即学习“PHP免费学习笔记（深入）”；
- 禁用无版本约束：
composer require monolog/monolog可能装 v3（不兼容 PHP 7.4），应写composer require monolog/monolog:^2.9 - TP 扩展安装后通常自动注册服务提供者，但前提是包本身带
think-service规范；若没生效，检查config/app.php的providers数组是否已追加对应类 - 私有包或未配 autoload 的本地类库：必须手动在
composer.json的autoload.psr-4里加映射，例如："app\service\": "app/service/"，然后运行composer dump-autoload -o - 切勿用
composer install替代require：前者只按composer.lock还原，不会把新包写入composer.json，下次部署就丢包
composer update 后项目崩了怎么办
ThinkPHP 主版本小号变更（如 6.0.x → 6.1.x）常含破坏性改动，update 默认全量升级，风险极高。
- 日常开发禁用裸
composer update；升级框架请用composer update topthink/framework显式限定范围 - 检查
composer.json中的版本约束："^6.0.0"比"6.*"更安全，后者可能跨小版本引入不兼容 - 升级前务必看 GitHub Releases 页面的
BC Breaks标签项，重点关注中间件、事件、验证器等核心机制变化 - 若已崩，先删
runtime/cache/和vendor/composer/autoload_*.php，再composer dump-autoload -o；仍不行就回退composer.lock并重装
最易被忽略的一点：vendor/ 目录绝对不要 git 提交、不能挪位置、不能删后手动复制——ThinkPHP 的 thinkinitializerLoader 硬编码读取 vendor/autoload.php，路径偏移直接导致所有类加载失败。
