ThinkPHP 8.0内置命令行工具链可快速生成控制器、中间件、命令类：执行php think make:controller、make:middleware、make:command；自定义命令需确保命名空间匹配、在config/console.php注册、configure()中完整定义setName()和setDescription()，才能出现在php think list中。
想快速生成控制器、中间件、命令类却反复手写命名空间和继承结构，或执行php think list时自定义命令不显示——这说明你还没真正用上ThinkPHP 8.0内建的命令行工具链和自动化生成能力，它不是可选项，而是开箱即用的开发加速器。
确认命令行环境是否就绪
打开终端，进入你的ThinkPHP 8.0项目根目录（含think文件、app/、config/、vendor/的那层），执行：
php think version
若提示【Class 'think\Console' not found】，说明vendor/autoload.php未加载——立刻检查是否执行过composer install且vendor/目录存在；若提示“Could not open input file: think”，Linux/macOS用户需运行chmod +x think赋予执行权限，Windows用户改用php think.php。
看到类似v8.0.12的输出，表示CLI环境已激活。
立即学习“PHP免费学习笔记（深入）”；
用php think make快速生成代码骨架
方法一：生成RESTful风格控制器
执行php think make:controller api/UserController --api
该命令会自动创建app/controller/api/UserController.php，继承think\Controller，并预置index/read/save/update/delete标准方法签名，省去手动声明HTTP动词对应逻辑。
方法二：生成中间件
执行php think make:middleware CorsMiddleware
在app/middleware/CorsMiddleware.php中生成标准handle()方法模板，你只需填充header逻辑，无需操心$request/$response参数注入细节。
方法三：生成自定义命令类
执行php think make:command sync:UserSync
生成app/command/SyncUserSync.php，已继承think\command\Command，configure()中预留了setName()和setDescription()调用位置，execute()里自动注入Input和Output对象——这一步省掉90%样板代码。
让自定义命令出现在php think list中
第一步：确认类文件路径与命名空间匹配
将刚生成的app/command/SyncUserSync.php的命名空间改为app\command，类名保持SyncUserSync不变。
第二步：在config/console.php中注册命令
找到commands数组，在末尾添加一行：
'app\command\SyncUserSync::class'
第三步：检查configure()方法是否完整
打开SyncUserSync.php，确保configure()方法内至少包含$this->setName('sync:user')和$this->setDescription('同步用户数据')两行；【漏掉setName()会导致php think list完全不显示该命令】
第四步：验证注册结果
执行php think list，搜索sync:user，应能立即看到该命令及其描述。
执行自定义命令并传参
执行php think sync:user --force --limit=500
注意：--force是布尔选项，无需赋值；--limit=500是值选项，等号不可省略。短横线参数必须在configure()中显式声明，否则$input->getOption()始终返回null。
在execute()方法中取值：
if ($input->getOption('force')) { // 强制执行逻辑 }
$limit = $input->getOption('limit') ?: 100;
位置参数如php think sync:user admin，需先在configure()中调用$this->addArgument('name')，再用$input->getArgument('name')获取——不声明就取值，永远是null。
