thinkphp 8.0安装自定义插件必须执行四步：一、在项目根目录（含composer.json和public/）运行composer require；二、手动将服务提供者类名添加至config/app.php的providers数组；三、复制vendor中插件的config/*.php到项目config/目录并设权限；四、执行composer dump-autoload -o刷新自动加载。
ThinkPHP 8.0 安装自定义插件，不是复制文件或改配置就能生效——必须走 composer require 流程、注册服务提供者、手动补配置（如需），缺一环就类找不到、命令不识别、中间件不触发。
用 composer require 安装，且必须在项目根目录执行
这是唯一被框架认可的安装路径。如果在错误目录（比如进了 public/ 或 app/）执行，vendor/ 会建错位置，自动加载失效。
- 先确认当前终端路径下有
composer.json和public/目录，再运行：composer require your-vendor/your-plugin - 若插件未发布到 Packagist，需在
composer.json的repositories中手动加 Git 地址，否则报Could not find package - 安装后检查
vendor/your-vendor/your-plugin/是否存在，且含src/和composer.json（尤其看是否有autoload段）
手动注册服务提供者到 config/app.php
ThinkPHP 8.0 不再自动发现服务提供者，dont-discover 默认为 ["*"]，意味着你装了也白装，除非显式注册。
- 打开
config/app.php，找到'providers' => [...]数组 - 把插件文档里写的类名（通常是
XXXServiceProvider::class）加进去，例如：hinkcaptchaCaptchaService::class - 如果插件没提供服务提供者（比如纯工具函数包），则跳过这步，但后续要手动
use或通过Loader::import()加载
复制默认配置文件到 config/ 目录（常见坑点）
很多插件（如 think-queue、think-swoole）安装后不会自动把 config/xxx.php 写进项目，运行时直接报 Config not found。
- 去
vendor/your-vendor/your-plugin/config/找默认配置文件（如queue.php） - 完整复制到项目根目录的
config/下，保持同名（config/queue.php） - Linux/macOS 下执行：
chmod 644 config/queue.php，避免因权限导致读取失败 - 若项目用了
.env，还需补上对应变量，例如：QUEUE_CONNECTION=database
刷新自动加载并验证类是否可解析
即使前面都做了，Class not found 还可能因为 PSR-4 映射没更新，或命名空间写错。
- 执行：
composer dump-autoload -o（加-o强制优化 autoload） - 写个临时测试脚本，
var_dump(class_exists('YourPlugin\Core\Handler'));看是否返回true - 若返回
false，检查插件composer.json中autoload的psr-4路径是否指向正确源码目录（比如是"src/"还是"src/Plugin/"）
最常被忽略的是服务提供者注册和配置文件复制——这两步不做，插件代码哪怕全在 vendor 里，框架也当它不存在。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
