ThinkPHP 6 的 addon 目录仅为约定位置，无原生插件机制；需引入 think-addons 等第三方包实现生命周期、依赖隔离等功能；插件须独立 composer.json、显式注册、禁止直接引用 app/ 类、配置需独立管理、事件需加前缀隔离、依赖接口契约与自动化测试保障兼容性。
ThinkPHP 6 的 addon 目录不是插件系统，只是约定位置
很多人一看到 app/addon 或 addons/ 就以为 ThinkPHP 自带完整插件机制，其实它只提供目录结构和基础加载入口，think-addons 这类第三方包才是实际支撑者。框架原生不管理插件生命周期、依赖隔离、热启停或版本共存——这些全得自己补。
实操建议：
- 别直接在
app/addon下写业务逻辑，先引入topthink/think-addons（v3+ 支持 TP6.1+） - 插件必须有独立
composer.json，且type设为think-addons - 插件内路由、事件、命令需通过
AddonsServiceProvider显式注册，不会自动扫描 - TP6.3+ 开始支持
addon_path配置，但路径变更后需同步改config/addons.php中的path
插件里调用业务模型会触发框架耦合
常见错误：插件中直接 use app\model\User;，结果升级主项目模型时，所有插件全报错。这不是“用了命名空间”就能解决的事——只要引用路径落在 app/ 下，就锁死了主项目结构和版本。
实操建议：
- 插件内部禁止 import 主项目任何
app\下的类，包括模型、服务、验证器 - 主项目对外暴露能力，统一走接口层：比如定义
App\Service\Contracts\UserServiceInterface，并在app/provider.php中绑定具体实现 - 插件通过容器获取接口：
app()->make(UserServiceInterface::class)->list()，而非 new 模型 - 接口定义应放在独立
app-contract包里，由主项目和插件共同 require，避免代码拷贝
插件配置与主项目环境变量混用导致部署失败
现象：本地开发时插件读 env('ALIYUN_OSS_KEY') 没问题，上线后突然空值。原因是插件配置没走 .env 加载流程，而是被主项目 config 缓存覆盖了。
实操建议：
- 插件自己的配置必须放在
addons/{name}/config.php，且在getAddonConfig()中显式合并 - 不要在插件里直接读
env()，改用config('addon_name.key')，并确保该 key 已在插件config.php中声明默认值 - TP6.2+ 的
config_cache默认开启，插件配置不会自动进缓存，需手动执行php think addon:refresh - CI/CD 中若清缓存，记得加这步，否则上线后插件配置仍用旧版
多插件共存时事件监听器冲突难定位
两个插件都监听 user.login 事件，一个改用户状态，一个发短信，但顺序错了导致短信发给未激活账号。TP 原生事件调度器不提供优先级、条件过滤或拦截机制。
实操建议：
- 禁用全局事件名裸写，全部加上插件前缀：
addon:wechat.user.login、addon:sms.user.login - 主项目统一派发事件时，用
event('user.login', $data)；各插件按需监听自己前缀的子事件 - 如真需共享事件，用中间件方式替代：定义
UserLoginPipeline，插件注册 handler 到 pipeline，由主项目控制执行顺序 - 调试时打开
log_event日志开关，日志里会显示每个监听器耗时，比 var_dump 更早发现卡点
插件化真正的难点不在加载，而在能力边界的持续维护——每次主项目加个新字段、改个验证规则、换数据库驱动，都可能悄无声息地断掉某个插件。没有契约文档和自动化兼容测试，所谓解耦只是暂时没出事。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
