最可靠方式是用 composer 安装，thinkphp 6+ 完全依赖 composer 管理，手动解压易缺 vendor 导致 class 'think\app' not found，官方已停供一键包。
直接用 composer require 安装模块扩展包
ThinkPHP 的「模块」不是指传统意义上的插件 ZIP 包，而是通过 Composer 管理的独立扩展包（如 think-queue、think-multi-app、think-view）。这些模块必须在已初始化的 ThinkPHP 项目中安装，不能在空目录或非项目根目录下执行。
常见错误现象：在项目外执行 composer require topthink/think-queue，或在 app/ 目录里运行，结果报错 Could not find a composer.json file 或依赖写入失败。
- 确认当前终端路径是项目根目录（含
composer.json、think文件、app/和config/目录） - 执行命令前先检查 PHP 版本是否匹配模块要求（例如
think-queue:^4.0要求 PHP ≥ 8.1） - 安装后务必验证 vendor 目录是否生成对应包（如
vendor/topthink/think-queue），并确认服务提供者是否自动注册（部分模块需手动在config/app.php的providers数组中添加）
tp6/tp8 安装多应用模块 think-multi-app
think-multi-app 是官方为 TP6+ 提供的多应用支持扩展，它不改变单应用默认结构，而是在运行时识别 app/xxx/ 子目录作为独立应用。安装后不会自动生成 app/admin/ 这类目录，只是启用多应用路由解析能力。
容易踩的坑：装完就以为“admin 模块已存在”，结果访问 /admin 报 404 —— 实际上你还得手动创建 app/admin/ 目录，并补全 controller/、route/ 等结构，或用 php think build --module admin 生成骨架。
- TP6.x 推荐使用：
composer require topthink/think-multi-app:^2.0 - TP8.x 必须用：
composer require topthink/think-multi-app:^3.0 - 安装后需清空
runtime/cache/，否则旧的单应用路由缓存仍生效 - 若使用
.env配置，确保APP_MULTI=true已开启（部分版本默认关闭）
安装模板引擎 think-view 后仍报 Class 'think\view\driver\Think' not found
这个错误不是因为没装包，而是 think-view 安装后未启用视图驱动，或配置项缺失。新版 ThinkPHP 默认不加载任何模板引擎，即使你 require 了 think-view，也得显式绑定驱动。
关键点在于配置文件位置和键名：TP6/TP8 的视图配置必须放在 config/view.php，且该文件需返回一个数组，其中 type 必须设为 think（对应 think\view\driver\Think 类），而不是 php 或留空。
- 执行
composer require topthink/think-view后，检查是否生成了config/view.php；若无，需从vendor/topthink/think-view/config/view.php复制过去 -
config/view.php中必须包含：'type' => 'think'，且'view_path'指向正确的模板目录（如app/view/） - 如果用了
.env，不能写VIEW_TYPE=think——view.php不读取环境变量，必须硬编码 - 调用
view()前确保控制器继承了think\Controller，否则$this->fetch()会失效
安装命令执行成功但模块功能不生效
最常被忽略的是 runtime 缓存未清理。ThinkPHP 在首次启动时会把配置、路由、服务提供者等编译进 runtime/ 下的 PHP 文件，后续修改配置或新增模块都不会自动重编译。
比如你刚 require 了 think-queue 并配好 config/queue.php，但执行 php think queue:listen 报错 “Command 'queue:listen' is not defined” —— 很可能只是因为命令行缓存没刷新。
- 每次安装新模块后，强制清空：
rm -rf runtime/*（Linux/macOS）或手动删除runtime/全部内容（Windows） - 若用
php think命令，额外执行：php think clear清除命令缓存 - Web 请求不生效？检查
runtime/log/下最新日志，看是否有Class not found或Driver not supported提示 - 某些模块（如
think-swoole）还依赖特定 PHP 扩展（如swoole），仅composer require不够，必须确认php -m | grep swoole输出有效
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
