插件必须放在与app/并列的addons/目录，name和path须严格一致且区分大小写，路由需显式声明，迁移用think-migration管理，敏感操作走中间件鉴权，新增类后执行composer dump-autoload -o。
技术总监在评审ThinkPHP插件时，关注的不是功能是否炫酷，而是它能否在高并发、多团队协作、长期迭代的生产环境中稳定存活——这要求插件从目录结构、加载机制到安全边界都经得起推敲。
插件必须放在与app/并列的addons/目录
直接在项目根目录下创建addons/文件夹，把插件解压进去，例如：addons/wechat_login/。
绝不能把插件塞进app/目录里——ThinkPHP默认把app/下的所有子目录都当作“应用”来扫描路由和自动加载，插件一旦混入，php think命令会报错、路由注册失败、类找不到，且问题极难定位。
addons/是TP6+官方约定路径，think-addons等主流插件包默认只读这里；若强行改用plugins/目录，必须手动在config/app.php中注册插件扫描路径，否则框架根本“看不见”它。
addon.php中name与path必须严格一致
打开addons/wechat_login/addon.php，检查return数组：
【name】必须和插件目录名完全相同（区分大小写），不能是WechatLogin或wechat-login；
【path】必须是命名空间根路径，用双反斜杠，末尾带反斜杠，例如'addons\wechat_login\'；若写成'addons/wechat_login/'（斜杠）或漏掉末尾反斜杠，类自动加载器将无法解析WechatLoginService这类类名。
这是评审时第一眼必查项：name不匹配→插件被框架跳过；path不合法→服务类加载失败→500错误。
路由必须显式声明，不依赖自动扫描
插件内控制器（如addons/wechat_login/controller/LoginController.php）不会被自动识别。
必须在插件同级目录下提供route.php文件，并用Route::group绑定完整命名空间：
Route::get('login','addons\wechat_login\controller\LoginController@index');
路由前缀（如wechat_login）应与插件name保持一致，避免多插件共存时发生前缀冲突。
没有route.php或未正确绑定命名空间 → 访问/wechat_login/login返回404，且无任何提示日志。
数据库迁移必须通过think-migration管理
第一步：在插件目录下执行composer require topthink/think-migration --dev；
第二步：在插件根目录运行php think migrate:create install_wechat_login_table；
第三步：编辑生成的迁移文件，定义up()和down()方法；
第四步：执行php think migrate:run —plugin wechat_login。
手写SQL建表语句或直接在控制器里执行Db::execute()建表，属于硬编码行为，会导致上线后无法回滚、环境间表结构不一致、CI/CD流程中断。
敏感操作必须走中间件鉴权
方法一：在插件route.php中为关键路由绑定中间件：
Route::get('bind','...')->middleware(['check_login', 'check_install']);
方法二：在控制器构造方法中调用middleware()链式注册：
$this->middleware(['check_login'])->except(['callback']);
绝不允许在控制器方法体内用if(!session('user')){exit;}这类裸判断——它绕过全局中间件生命周期，无法统一记录审计日志，也无法与SSO系统集成。
自动加载失效时必须执行composer dump-autoload -o
插件新增了服务类（如addons/wechat_login/service/WechatOAuthService.php），且该插件有独立composer.json时，必须在项目根目录执行：
composer dump-autoload -o
不加-o参数会导致优化类映射缺失，新类在生产环境无法加载；执行后无需重启Web服务器，但需确认vendor/composer/autoload_classmap.php中已出现对应类路径。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
