php think 命令必须在项目根目录或确保 vendor/autoload.php 已加载的环境下执行，否则因路径或自动加载失败导致 Class 'think\Console' not found 等错误；自定义命令需继承 think\command\Command、实现 configure() 和 execute()、在 config/console.php 中显式注册完整类名，并通过 addArgument/addOption 声明参数后方可读取。
ThinkPHP 8.0 的 php think 命令不是插件，是开箱即用的——但必须在项目根目录下执行，否则 99% 的报错都源于路径或 autoload 加载失败。
php think 命令在哪执行、为什么报 Class 'think\Console' not found
这个错误几乎全是路径和加载问题，跟代码无关。它只在两个地方能正常工作：一是项目根目录（含 think 或 think.bat 文件、app/、config/、vendor/），二是确保 vendor/autoload.php 已被加载。
- Linux/macOS 下进错目录时会提示
Could not open input file: think；检查当前路径是否真有think文件，没有就cd到对的地方 - 有
think文件但没权限？运行chmod +x think - Windows 下若提示“不是内部或外部命令”，别硬敲
think，直接用php think.php（部分环境未生成可执行包装器） - 如果
vendor/目录不存在，或composer install没跑完，autoload.php就不会存在，think脚本自然找不到think\Console
自定义命令类怎么注册、为什么 php think list 看不见你的命令
TP8 不靠自动扫描，所有命令必须显式注册，漏一个条件就隐身。
- 类必须继承
think\command\Command，不能是think\console\Command（那是 TP5/6 的旧路径） - 必须实现
configure()和execute()方法，且configure()中至少调用$this->setName('xxx:yyy')和$this->setDescription('...') - 类文件建议放
app/command/SyncUser.php，命名空间为app\command，别写错大小写 - 注册入口是
config/console.php中的commands数组，值必须是完整类名加::class，例如app\command\SyncUser::class，写成'SyncUser'或app\command\SyncUser都无效 - 别忘了在类里
use think\console\Input;和use think\console\Output;，否则execute(Input $input, Output $output)的类型声明会报错
参数和选项怎么取、为什么 $input->getOption('force') 总是 null
TP8 不自动解析任何参数，所有输入都得先声明、再读取，不声明=读不到。
立即学习“PHP免费学习笔记（深入）”；
- 位置参数（如
php think user:sync admin中的admin）必须在configure()中用$this->addArgument('name', ...)注册，然后用$input->getArgument('name')取值 - 选项参数（如
--limit=100）要用$this->addOption('limit', null, \think\console\InputOption::VALUE_REQUIRED)声明；布尔型选项（如--force）用InputOption::VALUE_NONE，判断时直接if ($input->getOption('force'))，别写=== true - 短选项字母必须小写、单字符，比如
$this->addOption('force', 'f', ...)才支持-f，-F或--Force都不认 - TP8 不支持 Laravel 那种隐式绑定或简写语法（如
--dry-run不能缩成-d），一切以addOption定义为准
最常被忽略的一点：TP8 的命令注册不是“写完类就生效”，而是依赖 config/console.php 的数组键值完全匹配、类文件物理路径与命名空间严格一致、且 composer dump-autoload 已更新——哪怕只改了一个字母，php think list 也不会显示它。
