必须同时满足插件在后台可见、install()可执行、目录结构合规三条件；插件目录名全小写无特殊字符，入口文件名须与目录名完全一致，命名空间和类名须匹配且继承正确Addon基类。
你想在ThinkPHP后台插件管理页看到自己的插件、点安装按钮能成功执行install()方法、插件目录结构不报错也不被系统跳过——这三件事必须同时满足，缺一不可，否则插件永远是“看不见、点不动、装不上”的黑盒。
创建插件目录与入口文件
在项目根目录下的addons/子目录里新建一个纯英文命名的文件夹，名字必须全小写、不能含空格和特殊字符，比如叫hello_world（注意不是HelloWorld或hello-world）。
进入这个hello_world文件夹，新建一个PHP文件，文件名必须和文件夹名完全一致，即hello_world.php；如果写成index.php、main.php或HelloWorld.php，【插件将彻底不被扫描到，后台列表里压根不会出现】。
用编辑器打开hello_world.php，第一行写命名空间：namespace addons\hello_world; 第二行开始写类定义，类名必须和文件名一致（hello_world），且继承think\addons\Addon（注意TP6+路径可能为think\addons\Addon，TP5为Think\Addons\Addon，务必核对vendor/thinkphp目录结构）。
立即学习“PHP免费学习笔记（深入）”；
定义硬性必需的$info数组
在hello_world.php的类定义外部、
'name' => 'hello_world', // 纯英文标识符，建议与目录名一致
'title' => 'Hello World 示例插件', // 后台显示的中文标题
'identifier' => 'hello_world.lwwan.plugin', // 全局唯一ID，格式为"插件名.开发者标识.plugin"，重复会导致安装失败
'version' => '1.0.0', // 三段式版本号，后续升级依赖此字段比对
'author' => 'lwwan', // 作者名，不能为空
注意：这个$info数组不是可选配置，而是插件注册成功的硬性契约；它必须出现在入口文件中，且不能包裹在类内部或函数里。
实现install()方法并确保返回true
打开hello_world.php，在hello_world类内部，写一个public function install() { }方法。
方法体里可以留空，也可以写数据库建表逻辑、写配置文件、初始化缓存等——但最关键的是最后一行必须显式写return true;，不能写return;、return null;、return 'success'; 或不写return。
如果install()没执行，大概率不是代码问题，而是runtime/目录不可写：Linux下需确保Web进程用户（如www-data）对该目录有写权限，chmod -R 775 runtime通常能解决；Windows环境则检查IIS或Apache服务账户权限。
install()执行前，ThinkPHP会自动清空插件缓存，所以改完代码后无需手动清缓存——但如果你之前装过同名插件又卸载了，建议删掉runtime/cache/addons.php再试。
验证插件是否被识别
第一步：确认项目已开启调试模式（config/app.php中'app_debug' => true）。
第二步：访问后台「插件管理」页面，刷新后看列表里是否出现了「Hello World 示例插件」这一行。
第三步：如果出现，点击「安装」按钮；若提示“安装成功”，说明runtime可写、install()返回true、$info完整——三者全部达标。
第四步：若点击无反应或提示“安装失败”，立刻检查runtime/权限、$info数组完整性、install()末尾是否return true；不要先怀疑代码逻辑。
