ThinkPHP 8 的 command 目录必须为 app/command，不可改名或移动；命令类须继承 think\Command、命名空间为 app\command（或其子命名空间），且框架不支持自定义扫描路径。
ThinkPHP 8 的 command 目录不能直接改名或移动
ThinkPHP 8 内置的命令行支持（类似 Laravel Artisan）硬编码依赖 app/command 这个路径，框架启动时会自动扫描该目录下继承 think\Command 的类。你改目录名、挪位置、甚至在 config/console.php 里配路径都没用——框架根本不会读这个配置。
常见错误现象：php think list 不显示自定义命令，或报错 Class not found，但类文件明明存在、命名空间也对。
- 确认类文件放在
app/command下，不是app/commands或app/console - 类必须继承
think\Command，且实现configure()和handle() - 命名空间必须是
app\command（或子命名空间如app\command\demo），不能写成App\Command
想“假装”有 Artisan 风格？别动路径，动入口和调用方式
ThinkPHP 没有 artisan 可执行文件，它的命令入口是根目录的 think 脚本。所谓“自定义 Artisan 目录”，本质是想统一命令组织或复用 Laravel 习惯——但强行模拟反而增加维护成本。
使用场景：团队里有人熟悉 Laravel，想让 ThinkPHP 命令看起来像 php artisan make:controller。
立即学习“PHP免费学习笔记（深入）”；
- 可以写一个 shell 别名，比如
alias artisan='php think'，但这只是终端层面的障眼法 - 不要试图把
think脚本重命名为artisan并改内部路径逻辑——它依赖think\Console初始化流程，改了容易崩 - 如果真要扩展命令能力（比如支持
make:前缀），应该写一个基础命令类，在app/command下继承它，而不是折腾目录结构
think\Console::init() 不接受自定义命令路径参数
有些用户翻源码看到 think\Console 类，以为能传参覆盖扫描路径。实际上 Console::init() 是静态方法，只负责加载默认命令和事件，不提供路径注入点；命令发现逻辑在 think\console\CommandCollection 里，路径写死为 app/command。
性能影响：每次运行命令都会重新扫描 app/command 下所有 PHP 文件。如果放了几十个未启用的命令类，会有轻微加载开销，但通常可忽略。
- 别在
app/command里塞大量 .php 文件（尤其是测试用的、废弃的） - 不需要“按模块分命令目录”，ThinkPHP 不支持命令目录嵌套扫描，
app/command/v1/SyncCommand.php默认不会被识别 - 若需逻辑分组，用命名空间即可，例如
app\command\sync\SyncUserCommand，类名仍需在app/command目录下（或其子目录），且命名空间与路径严格对应
真正需要“自定义”的地方，其实是命令注册时机和容器绑定
如果你的需求是动态加载某些命令（比如插件里的命令、运行时生成的命令），那重点不在路径，而在 think\Console 的生命周期钩子。
兼容性注意：TP 8.0+ 使用容器自动绑定命令，但只扫描 app/command；你想加外部命令，得手动调用 $console->add()。
- 在
app/bootstrap.php或服务提供者中，获取控制台实例：app('think\Console') - 手动实例化你的命令类（确保已加载），然后调用
$console->add($command) - 注意：这样加的命令不会出现在
php think list的自动扫描列表里，但能正常执行，比如php think your:custom - 别在
configure()里做耗时操作，命令元信息应在类定义阶段就确定好
