TP5.1与TP6.x插件机制完全不同：TP5.1原生支持，入口addon.php、路径application/addons/、自动扫描；TP6.x依赖think-addons包，入口bootstrap.php、路径addons/、需手动refresh，且配置、路由、视图、服务注册均不兼容。
ThinkPHP 5.1 和 6.x 的插件加载机制完全不同
TP5.1 用 think\addons\Addons 类 + addons.php 配置驱动，插件目录默认在 application/addons/；TP6.x 彻底移除了原生插件支持，改由 think-addons 第三方包实现，且依赖容器和命令行注册，插件路径默认是 addons/（根目录下）。不区分清楚这点，直接把 TP5 插件扔进 TP6 项目里，连 php think addon:install 都会报错 Class "think\addons\Addons" not found。
- TP5.1 插件入口是
addon.php，TP6.x 要求是bootstrap.php（或通过service_provider声明） - TP6.x 必须运行
php think addon:refresh才能识别新插件，TP5.1 是运行时自动扫描 - TP5.1 的
config/addons.php在 TP6.x 中无效，配置要写进config/addon.php（由第三方包约定）
想一套代码跑 TP5.1 和 TP6.x？别硬扛，用条件加载
强行写“兼容层”容易漏掉生命周期差异——比如 TP6.x 的事件绑定必须在 bootstrap.php 中通过容器注册，而 TP5.1 可以在插件控制器里直接调 Hook::listen()。更稳妥的做法是：插件内部按版本分发逻辑，而不是试图统一接口。
- 检测框架版本用
think\App::VERSION（TP5.1）或think\Container::getInstance()->version()（TP6.x），但注意 TP6.x 的think\Container类在早期 beta 版本中路径不同，建议用class_exists('think\Container')先判存 - 路由注册方式不同：TP5.1 用
Route::rule()，TP6.x 推荐在插件的routes.php中返回数组，由主框架合并 - 视图渲染路径：TP5.1 默认找
application/addons/{name}/view/，TP6.x 默认是addons/{name}/view/，需在插件初始化时动态设置View::config(['view_path' => $path])
TP6.3+ 使用 think-addons 时常见的坑
官方推荐的 zoujingli/think-addons 包在 TP6.3 后有 Breaking Change：不再自动加载插件的 service_provider，必须手动在 config/app.php 的 providers 数组里追加，否则插件里的服务、中间件、事件监听全失效。
- 错误现象：插件已启用，但自定义命令不出现、中间件没触发、
Event::trigger()没响应 - 正确做法是在主项目
config/app.php中加入：'providers' => [addons\YourAddon\ServiceProvider::class]（注意命名空间路径） - TP6.3+ 的容器作用域变了，插件内不能直接 new 实例再 bind，要用
$app->bind()或在register()方法里注入 - 插件配置文件
config.php在 TP6.x 中不会自动合并到全局 config，必须在ServiceProvider::boot()里手动调Config::set($config, 'your_addon')
跨版本插件发布时，composer.json 的约束怎么写
不要写 "topthink/framework": "^5.1 || ^6.0" —— 这会让 Composer 安装时随机满足其一，但实际运行时仍可能因类名、方法缺失崩溃。必须拆成两个独立包，或至少用 replace + conflict 显式隔离。
立即学习“PHP免费学习笔记（深入）”；
- 推荐方案：插件包命名为
yourname/addon-tp5和yourname/addon-tp6，各自声明严格依赖，避免用户误装 - 如果坚持单包，
composer.json中必须同时写："conflict": {"topthink/framework": ">=6.0.0 （因为 6.3 是分水岭），并用 <code>autoload-files按版本加载不同引导文件 - 测试环节必须覆盖 TP5.1.42、TP6.0.13、TP6.3.5 三个典型版本，尤其注意 TP6.0 到 6.1 的容器重构导致的 bind 失效问题
版本兼容不是靠 if-else 堆出来的，是靠对生命周期、容器行为、配置加载时机的理解压出来的。漏掉任意一个点，上线后都是静默失败。
