webman命令无法识别需安装webman/console并注册；插件路由需手动引入；composer插件必须声明"type":"composer-plugin"且正确配置autoload与extra.class。
立即进入“php学习资料，零基础速成！☜☜☜☜☜点击进入”；
php webman 命令无法识别
直接执行 php webman 报错“Command 'webman' not found”，说明 webman/console 未安装或未启用。Webman 默认不带命令行支持，必须显式引入。
- 运行
composer require webman/console安装控制台扩展 - 检查
config/plugin.php是否已自动注册webman/console—— 若没有，手动追加'webman/console' => [] - 确认
start.php中是否调用了Plugin::init()（新版 Webman 默认已包含，老项目需自查） - 执行后仍报错？用
php webman list测试，若提示“no commands defined”，说明插件未被扫描到，可临时清空runtime/container目录重试
创建应用型插件时路由不生效
用 php webman app-plugin:create dingdingtalk 生成插件后，访问 /app/dingdingtalk 返回 404，大概率是路由未加载或控制器命名不匹配。
ApiPost是一个支持团队协作，支持模拟POST、GET、PUT等常见请求，并可直接生成文档的API调试、管理工具，ApiPost是后台接口开发者或前端、接口测试人员的工作必备工具。快速生成、一键导出API文档。感兴趣的朋友快来下载吧。软件说明ApiPost官方版是一款十分出色的接口调试与文档生成工具，ApiPost官方版界面美观大方，功能强劲实用，支持团队协作，支持模拟POST、GET、PUT等常见请求，是后台接口开发者或前端、接口测试人员的工作必备工具。软件特色更方便支持接口调试的同时快速生成、一键
- 检查插件目录下
plugin/dingdingtalk/config/route.php是否存在且返回了有效路由数组（如return ['GET /app/dingdingtalk' => [...]]） - 确认控制器类名与文件路径一致：应为
plugin/dingdingtalk/controller/IndexController.php，类名为plugindingdingtalkcontrollerIndexController - Webman 不会自动扫描插件内的
route.php，必须在主项目的config/route.php中手动require插件路由文件，或改用Route::import() - 修改后需重启服务（
php start.php restart），热更新不触发插件路由重载
composer plugin 类型声明缺失导致配置不合并
你写了 config/plugin/tinywan/encryption/app.php，但 config('plugin.tinywan.encryption.app') 始终返回 null —— 这不是路径写错，而是 Composer 插件根本没被激活。
-
composer.json中必须明确声明"type": "composer-plugin"，仅写"type": "library"无效 - 必须依赖
"composer-plugin-api": "^2.0"，不能写成"composer/composer" -
extra.class必须指向一个实现ComposerPluginPluginInterface的类，且该类要能被 PSR-4 自动加载（例如"autoload": {"psr-4": {"Tinywan\Encryption\": "src/"}}） - 插件激活后，需在
activate()方法里主动复制模板配置到主项目config/plugin/下，Webman 不会帮你做这一步
插件中读取 config 失败的常见陷阱
在插件代码里调用 config('app.debug') 没问题，但 config('plugin.xxx.yyy') 返回空值，往往卡在配置合并时机或作用域上。
- Webman 合并插件配置发生在容器初始化早期，若你在
Plugin::init()之前（比如在start.php顶部）就调用config()，此时插件配置尚未载入 - 插件配置键名必须严格匹配目录结构：
plugin/xxx/yyy/config/app.php对应config('plugin.xxx.yyy.app')，多一层或少一层都会失败 - 不要在插件的
src/类中直接use supportConfig，应统一走config()函数，避免因加载顺序导致 Config 实例未就绪 - 调试时可用
var_dump(config())查看当前已合并的全部配置，确认目标键是否存在
命令行只是入口，真正卡住人的永远是配置加载链和生命周期顺序。插件能否跑通，80% 取决于 composer.json 类型声明和 extra.class 是否正确，剩下 20% 是配置路径拼写和启动时机——别在路由或控制器上反复折腾，先盯死这两处。
