ThinkPHP本身不内置插件管理模块，所谓“安装插件”本质是引入第三方扩展包或手动集成可插拔模块；composer install仅按composer.lock复原依赖，不安装新包，必须用composer require才可靠生效。
ThinkPHP 本身不内置插件管理模块，所谓“安装插件”，本质是引入第三方扩展包或手动集成可插拔模块——直接执行 composer install 或 php think addon:install 这类命令，99% 的情况下不会生效，甚至会破坏项目。
为什么 composer install 装不上新插件
它只按 composer.lock 复原已有依赖，完全忽略你输入的包名。比如你输 composer install topthink/think-captcha，Composer 会把 topthink/think-captcha 当作无意义参数丢弃，vendor/ 里依然没有这个目录。
- 现象：执行后没报错，但
use think\captcha\Captcha报类不存在 - 根本原因：不是在项目根目录（含
composer.json和public/的目录）下运行命令 - 验证方式：运行
ls -la | grep composer.json（macOS/Linux）或dir composer.json（Windows），确保当前路径能看见该文件
composer require 是唯一可靠安装方式
它会写入 composer.json、触发自动加载注册、下载包到 vendor/，并兼容 ThinkPHP 的服务发现机制。
- 正确命令：
composer require topthink/think-captcha（TP6）、composer require topthink/think-addons（TP5.1+ 插件系统） - 装完必须检查：
vendor/topthink/think-captcha/src/CaptchaService.php是否存在，否则说明下载失败或版本冲突 - TP6 扩展大多自带服务提供者自动注册；TP5.1 则需手动在
config/app.php的providers数组中添加think\captcha\CaptchaService::class
警惕“伪插件包”和入侵式安装脚本
很多打着“一键安装”旗号的压缩包，实际是整套框架镜像或手动拼凑的 zip，误装会导致核心类丢失、路由失效等硬伤。
立即学习“PHP免费学习笔记（深入）”；
- 典型特征：
addons/目录下没有addon.json和Plugin.php；压缩包内含完整thinkphp/目录；要求你替换public/index.php或修改thinkphp/base.php - 真正可用的插件结构必须满足：
addons/插件名/addon.json+addons/插件名/Plugin.php+service_provider注册逻辑 - 声称支持“多站点会员同步”但代码里只有硬编码数据库连接、无事件监听或钩子调用的，基本是功能虚假宣传
最易被忽略的一点：TP5 和 TP6 的扩展不能混用。检查插件的 composer.json 里是否声明了 "topthink/framework": "^6.0"，而不是 "thinkphp/framework": "^5.1" —— 后者是旧版打包残留，会导致 Facade 类找不到。版本错配不是报错，而是静默失效。
