必须用composer require安装ThinkPHP6扩展组件，因create-project仅用于初始化完整框架项目；组件如think-queue、think-view等均为独立包，需通过require引入依赖树并配合配置文件落地与dump-autoload刷新自动加载。
必须用 composer require 安装组件，不能用 composer create-project —— 后者只用于初始化整个框架项目，不是装组件的命令。
为什么 composer require 是唯一正确方式
ThinkPHP 6+ 的组件（如队列、多应用、视图引擎）全部以独立 Composer 包形式发布，topthink/think-queue、topthink/think-multi-app、topthink/think-view 都是扩展包，不是框架本体。用 create-project 去“装”它们会失败，因为那命令只认 topthink/think 这个根项目包。
常见错误现象：Could not find package topthink/think-queue 或安装后 php think queue:listen 报错 Command "queue:listen" is not defined，本质是包没进依赖树，或服务提供者没注册。
- 确保当前目录是项目根目录（含
composer.json和think文件） - 执行前先
composer clear-cache，避免本地缓存污染导致版本解析失败 - 国内用户若卡在下载，临时切阿里云镜像：
composer config -g repo.packagist https://mirrors.aliyun.com/composer/
composer require 的版本控制要点
组件和 ThinkPHP 主框架版本必须对齐，否则会出现类找不到、方法不存在、服务注册失败等问题。不指定版本号容易引入不兼容更新。
立即学习“PHP免费学习笔记（深入）”；
- TP6.3 + PHP ≥ 7.2 →
composer require topthink/think-queue:^3.0 - TP8.0 + PHP ≥ 8.1 →
composer require topthink/think-queue:^4.0 - 装视图引擎：
composer require topthink/think-view（无版本强约束，但建议搭配 TP 版本最新 patch） - 装多应用：
composer require topthink/think-multi-app（TP6 默认不带，TP8 已内置，无需额外装）
装完立刻验证：composer show topthink/think-queue 看输出的 version 是否落在预期范围内；再检查 vendor/composer/installed.json 中对应项的 version 字段。
装完组件后常被忽略的三件事
很多问题不是装错了，而是装完没走完最后几步。尤其在非标准环境（如禁用了 Composer 自动发现、或自定义了 app.php）下，组件代码存在但根本不会加载。
- 确认
config/queue.php是否存在：TP6/TP8 的think-queue包安装后**不一定自动生成**该文件，若缺失，手动复制vendor/topthink/think-queue/config/queue.php到项目config/目录 - 检查
config/app.php中'providers'数组是否包含'think\queue\service\QueueService::class'；TP8 默认启用自动发现，TP6 某些定制项目需手动加 - 运行
composer dump-autoload强制刷新类映射——尤其当你改过composer.json或手动增删过vendor/内容时，这步跳过会导致Class not found
最易被忽略的是配置文件落地和自动加载刷新，这两步不做，php think queue:listen 或 Queue::push() 调用会静默失败或直接报错。
