ThinkPHP 6.0.1 自定义命令必须重写类结构：路径为 app/command/、类名以Command结尾、命名空间为app\command、execute()开头需调用$this->app->initialize()，且config/console.php中commands必须为空数组。
ThinkPHP 5.1 的自定义命令行类在 6.0.1 中无法直接运行，必须重写类结构、调整路径、显式初始化应用上下文，否则 php think list 不显示、Db:: 报错、“No application initialized” 是必现问题。
自定义命令类路径和命名必须严格匹配 TP6 规范
TP5.1 允许把命令类放在 application/command/ 或任意目录并手动注册；TP6.0.1 只扫描 app/command/ 目录，且有硬性校验：
- 文件必须放在
app/command/（不是app/commands/、application/command/或子目录） - 类名必须以
Command结尾，如BackupDatabaseCommand - 文件名必须与类名完全一致，大小写敏感：
BackupDatabaseCommand.php✅，backupdatabasecommand.php❌ - 命名空间必须是
app\command，不能是app\command\backup或application\command
execute() 开头必须调用 $this->app->initialize()
TP5.1 命令执行时自动加载应用上下文；TP6.0.1 默认不初始化，所有 Facade（Db::、Config::、模型静态调用）和依赖注入都会失败。
错误写法（直接报错）：
立即学习“PHP免费学习笔记（深入）”；
protected function execute(Input $input, Output $output)
{
$users = User::where('status', 1)->select(); // ❌ No application initialized
}
正确写法（必须加初始化）：
protected function execute(Input $input, Output $output)
{
$this->app->initialize(); // ✅ 关键一行，不可省略
$users = User::where('status', 1)->select();
$output->writeln('Found ' . count($users) . ' active users');
}
- 推荐进一步改用容器获取实例：
$this->app->model(User::class)替代User::静态调用，确保事件、验证器、软删除等完整生效 - 不要在命令中
new User()，会绕过容器，丢失所有生命周期钩子
配置文件 config/console.php 必须返回空数组启用自动发现
TP5.1 需手动在 command.php 中注册类；TP6.0.1 默认启用自动发现机制，但前提是 config/console.php 中的 commands 配置项必须为空数组。
❌ 错误写法（关闭自动发现，且格式非法）：
return [
'commands' => ['app\command\BackupDatabaseCommand']
];
✅ 正确写法（启用自动发现）：
return [
'commands' => []
];
- 如果项目中原来有
application/command.php（TP5.1 风格），请直接删除它——TP6 不读这个文件 - 修改后必须清缓存：
php think clear，否则旧命令列表仍被缓存，新命令不会出现在php think list
命令名定义和参数处理方式微调
setName() 和参数定义逻辑基本一致，但 TP6.0.1 对命令名格式更严格：
- 命令名只能含小写字母、数字、冒号（
:）、下划线（_），不能有空格或大写，如backup:database✅，BackupDatabase❌ - 添加参数需用
Argument::REQUIRED或Argument::OPTIONAL，不再支持 TP5.1 的字符串标识符 - 选项值必须显式声明类型：
Option::VALUE_REQUIRED，不能只写'city'
示例片段：
protected function configure()
{
$this->setName('backup:database')
->setDescription('备份指定数据库表到 SQL 文件')
->addArgument('table', Argument::REQUIRED, '表名，如 users')
->addOption('output', null, Option::VALUE_REQUIRED, '输出路径，默认为 storage/backup/');
}
真正容易被忽略的是：TP6 命令的生命周期里，configure() 只注册元信息，execute() 才真正执行业务逻辑——而这个逻辑能否访问数据库、缓存、配置，全取决于你有没有那一行 $this->app->initialize()。漏掉它，其他都白搭。
