ThinkPHP 6 必须用 Composer 安装，唯一正确方式是 composer create-project topthink/think tp6；其他方式（如下载 ZIP、空目录下 composer install）会导致自动加载缺失、Class not found 或白屏。
ThinkPHP 本身不强制绑定 Composer，但现代 ThinkPHP（6.x+）完全基于 Composer 构建，composer 不是“怎么用”，而是“必须用”——没它连框架都装不起来。
安装 ThinkPHP 6 必须走 composer create-project
直接下载 ZIP 或手动复制 vendor 文件夹会缺失自动加载、依赖版本约束和事件钩子，后续升级或加扩展必然报错。
-
composer create-project topthink/think tp6是唯一推荐的初始化方式 - 别用
composer install在空目录下跑——没有composer.json就没东西可装 - 如果提示
Could not find package topthink/think，先运行composer clear-cache，再换国内镜像：composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意：该镜像已停用，应改用https://mirrors.aliyun.com/composer/）
composer require 加扩展时要注意命名空间和版本兼容
ThinkPHP 6 的扩展包大多以 topthink/think-xxx 命名，但不是所有都适配 TP6；比如 think-wechat 是社区维护的，官方未认证，得看其 composer.json 里是否声明 "thinkphp": "^6.0"。
- 加包前先确认文档是否写明 “支持 ThinkPHP 6” —— TP5 的包在 TP6 下大概率报
Class not found - 避免无版本号直加：
composer require topthink/think-captcha可能装最新版（如 v4），而 TP6.3 默认只认 v3；应显式指定：composer require topthink/think-captcha:^3.0 - 装完后检查
config/app.php是否自动注册了服务提供者；没注册就得手动加到providers数组里
本地开发改了 composer.json 后，composer update 很危险
TP6 的核心包（topthink/framework）和扩展之间有强版本耦合，composer update 默认升级所有包，极易导致 Method not found 或 Call to undefined function。
立即学习“PHP免费学习笔记（深入）”；
- 只更新某个包：用
composer update topthink/think-queue，别光输composer update - 升级框架主版本（如 6.0.x → 6.3.x）前，务必查官方 迁移指南，尤其关注中间件、事件、验证器等 API 变动
- 改完
composer.json后，建议先composer update --dry-run看实际要动哪些包，再决定是否执行
最常被忽略的一点：TP6 的命令行工具（php think）本质是 vendor/bin/think 的符号链接，一旦 composer install 失败或权限异常，这个文件就失效——此时运行 php think 报错 command not found，但错误信息根本不提“找不到 bin 文件”，只会卡在 autoload 阶段。遇到这种问题，先 ls -l vendor/bin/think 看链接是否存在且可读。
