ThinkPHP插件需通过composer require安装并注册服务提供者，否则use报错、Facade失效；extend目录需手动注册命名空间；配置文件须放指定路径，行为类要正确绑定钩子点。
ThinkPHP 插件不能直接丢进 extend 目录就用，必须走 Composer 自动发现或手动注册服务提供者，否则 use 报错、Facade 不生效、配置不加载——这是 90% 新手卡住的第一步。
为什么 composer install 装不上新插件？
因为 composer install 只按 composer.lock 还原已有依赖，它完全忽略你命令行里写的包名。哪怕你输 composer install topthink/think-captcha，也只会静默跳过。
- 正确命令永远是
composer require vendor/package（例如composer require topthink/think-captcha） - 执行前确认当前目录含
composer.json（运行ls composer.json或dir composer.json验证） - 装完检查
vendor/下是否出现对应目录；没出现就是路径错了或命令用错了 - 如果报 “Class not found”，大概率是服务提供者没注册，不是类文件没下载
插件装上了却 use 不到类？查这三处
ThinkPHP 第三方插件（尤其是 TP6+）依赖服务提供者（Service Provider）自动注册，不是“放进去就能用”。
- 看
config/app.php的'providers'数组，确认是否已加入类似think\captcha\CaptchaService::class的条目 - 打开
composer.json，搜索dont-discover：如果值是["*"]，说明全局禁用了自动发现，删掉这行或改成精确值（如["topthink/framework"]） - 部分插件（如
topthink/think-queue）不会自动生成配置文件，需手动从vendor/topthink/think-queue/config/queue.php复制到项目config/queue.php
extend/ 目录里的自定义类怎么注册才能用？
extend/ 不是自动加载区，框架默认完全不扫描它。想让里面的东西可用，必须显式注册命名空间。
立即学习“PHP免费学习笔记（深入）”；
- 在
app/common.php或服务提供者的register()方法里加：Loader::addNamespace('mylib', EXTEND_PATH . 'mylib/'); - 类文件需声明命名空间，比如
extend/mylib/Helper.php要写namespace mylib;，调用时用new mylib\Helper() - 若想封装成门面（Facade），必须在门面类中重写
getFacadeClass()，返回完整类名（如'extend\utils\JsonFormatter'），且在config/app.php的'facade'数组里加映射 - 扩展自带的配置（如
alipay.php）不能直接扔进config/，要放extra/alipay.php才会被合并加载
行为（Behavior）类和钩子点怎么配才生效？
行为类本质是轻量插件，靠绑定到预定义钩子点（如 action_begin、view_filter）触发，不是独立服务。
- 行为类必须继承
think\behavior，并实现run($params)方法 - 绑定方式优先用
config/tags.php配置：'action_begin' => ['app\behavior\LogBeforeAction'] - 不要在控制器里用
Hook::add()动态注册，容易漏触发或重复注册 - 钩子点名必须严格匹配框架内置名称（查
think\App源码或官方文档），拼错一个字母就不会触发 - 行为里避免耗时操作（如远程请求、大文件读写），否则会拖慢整个请求生命周期
最常被忽略的是：插件配置文件位置、服务提供者注册状态、以及 extend/ 命名空间的手动加载——这三项没对齐，代码写得再对也跑不起来。
