ThinkPHP 5.1 仅扫描 app/command 目录且要求继承 thinkConsoleCommand、命名空间严格匹配；TP6 关闭自动发现，需在 config/console.php 中显式配置 commands 并继承 thinkcommandCommand。
ThinkPHP 5.1 的 php think 命令不识别自定义命令？
核心原因：TP5.1 默认只扫描 app/command 目录，且要求类必须继承 thinkConsoleCommand（不是 thinkcommandCommand），命名空间也必须严格匹配目录结构。
- 常见错误现象：
php think list看不到你的命令，或报错Class not found - 正确做法：确保类文件路径为
app/command/YourCommand.php，命名空间是appcommand，类名用 PascalCase，且继承thinkConsoleCommand - 注意
configure()方法里必须调用$this->setName('your:command')，否则命令不会注册到列表中 - TP5.1 不支持在
config/console.php中动态注册命令，只能靠自动扫描
ThinkPHP 6.x 的 think 命令为什么找不到 app/command 下的类？
因为 TP6 默认关闭了命令自动发现，改用配置驱动 —— 这是和 5.1 最关键的行为差异。
- 使用场景：升级到 TP6 后原有命令突然失效，
php think list输出为空 - 解决方法：在
config/console.php中显式添加配置项：'commands' => ['app\command\YourCommand'] - 参数差异：TP6 的命令类必须继承
thinkcommandCommand，构造函数签名和execute()方法签名也略有调整（比如不再强制 require$input和$output参数） - 兼容性影响：TP6 支持 PSR-4 自动加载，但如果你用了非标准命名空间（比如
commoncommand），必须手动加进commands配置，否则完全不可见
TP5.1 和 TP6.x 共用同一套命令逻辑时怎么避免运行时报错？
不能直接复用。两个版本的基类、生命周期钩子、输入输出对象类型都不同，混用会触发 Fatal Error 或静默失败。
- 常见错误现象：把 TP6 的命令类丢进 TP5.1 项目，执行时报
Class 'thinkcommandCommand' not found；反之在 TP6 中继承thinkConsoleCommand会提示方法不存在 - 实际做法：用条件判断版本号做隔离，例如在命令类开头加
if (version_compare( hinkApp::VERSION, '6.0.0', '，但更推荐物理隔离 —— 分开维护两套命令目录 - 性能影响：TP6 的命令注册走配置+反射，比 TP5.1 的自动扫描略慢一点，但差异可忽略；真正耗时的是命令本身逻辑
- 注意 TP6.3+ 开始支持命令分组（
group配置），TP5.1 完全不支持，别在低版本尝试
如何让一个命令同时支持 TP5.1 和 TP6.x 的参数解析行为？
关键是绕过框架自带的参数绑定，统一用原始 $argv 解析，再手动映射到业务逻辑。
立即学习“PHP免费学习笔记（深入）”；
- 原因：TP5.1 的
$input->getArgument()返回 null 时行为不稳定；TP6.x 的$input->getArgument('name')在未定义时抛异常，二者对缺失参数的处理不一致 - 实操建议：在
execute()开头加一行$rawArgs = array_slice($_SERVER['argv'], 2);，然后自己 parse，比如用array_shift($rawArgs)拿 action，用in_array('--force', $rawArgs)判开关 - 这样写虽然失去框架的参数校验便利，但换来跨版本稳定性；尤其适合运维脚本类命令，不需要复杂 help 文档
- 别依赖
$input->getOption()的返回类型 —— TP5.1 返回 string，TP6.x 可能返回 bool 或 null，容易引发 Notice
