config/console.php 是 TP6+ 命令注册的唯一入口，必须返回含 commands 键的数组，值为完整类名::class；TP5.1 依赖自动扫描，不读该文件，升级时遗漏配置是命令失效主因。
config/console.php 是 TP6+ 命令注册的唯一入口
ThinkPHP 6.0 及之后版本（含 TP8）**完全关闭自动扫描**，config/console.php 不是可选配置，而是命令能被 php think list 看见的刚性前提。不配，命令就不存在。
常见错误现象：php think list 输出为空，或执行时报 Command "xxx" is not defined，但类文件明明存在、命名空间也对。
-
config/console.php必须返回一个带commands键的数组，值为完整类名 +::class，例如：app\command\BackupData::class - 键名不能随便写——TP8 不认键名，只认类；但 TP6 允许用字符串键映射命令别名，如
'backup:data' => 'app\command\BackupData'，此时必须确保类中setName('backup:data')与之严格一致 - 不要在数组里混写字符串类名（如
'app\command\BackupData'）和::class，TP8 只接受后者；TP6 两者都支持，但混用易引发 autoload 失败
为什么 TP5.1 不需要 config/console.php？
TP5.1 是靠硬编码路径自动发现：只要类放在 app/command/ 下、继承 think\Console\Command（注意不是 think\console\Command）、命名空间为 app\command，框架启动时就会加载。它根本不读 config/console.php。
升级到 TP6 后原有命令失效，90% 是因为没补上 config/console.php 配置，而不是代码写错了。
立即学习“PHP免费学习笔记（深入）”；
- TP5.1 的命令类必须实现
execute(Input $input, Output $output)，且configure()中必须调用$this->setName('xxx')，否则即使文件存在也不会注册 - TP6/TP8 的
execute()方法签名更宽松，可省略类型提示，但推荐保留Input和Output类型，避免 IDE 报错 - TP5.1 没有
config/console.php这个概念，你新建了它也不会被加载——框架压根不看这个文件
commands 数组里的类没生效？先查这三件事
配置写了，类也注册了，但命令还是不出现。问题往往不在逻辑，而在加载链最前端。
- 确认
config/console.php文件真实存在，且位于config/目录下（不是app/config/或其他位置） - 确认该文件返回的是数组，且顶层键为
commands，例如：return ['commands' => [app\command\SyncUser::class]]; - 确认类文件路径与命名空间完全匹配：类在
app/command/SyncUser.php，命名空间就得是app\command，不能是App\Command或app\command\sync（除非你手动加了 PSR-4 映射）
想动态加载命令？别动 config/console.php
有人试图在 config/console.php 里写 glob() 扫描目录、或 require 多个文件来“自动注册”，这不可靠。TP6/TP8 的命令加载发生在容器初始化早期，此时 glob() 可能因路径未解析而失败，且违反配置即代码的原则。
真正需要批量管理时，应该：
- 用
php think make:command统一生成骨架，保证结构一致 - 把命令按业务域分组进子命名空间，如
app\command\sync\SyncUserCommand，仍注册为app\command\sync\SyncUserCommand::class - 如果真要自动化注册，应在服务提供者（如
app/provider/ConsoleServiceProvider.php）中通过$this->app->bind或事件监听注入，而不是塞进配置文件
配置文件是静态契约，不是运行时脚本。改它不如改注册方式本身。
