Artisan命令须在Laravel项目根目录执行，确认方法为检查artisan文件及vendor目录存在；自定义命令需注册到Kernel.php或满足Laravel 10+自动发现条件，并清除配置缓存；$signature中空格和等号位置必须准确。
Artisan 命令必须在 Laravel 项目根目录下执行，否则 php artisan 会报 “command not found” 或 “No such file or directory” —— 这不是 Artisan 不存在，而是你根本没进对地方。
怎么确认自己在正确的项目根目录
Artisan 是一个真实存在的可执行文件（artisan），和 composer.json、app/、vendor/ 在同一级目录。别猜，直接验证：
- 运行
ls -la | grep artisan（macOS/Linux）或dir artisan（Windows CMD）看文件是否存在 - 检查
vendor/是否存在且非空；如果刚克隆项目但没跑composer install，php artisan必然失败 - Windows 用户注意：不要双击
artisan，必须用php artisan调用；Git Bash 下有时需写php ./artisan - 用 Laravel Sail？换成
./vendor/bin/sail artisan，别直接用php artisan
php artisan list 报错或不显示自定义命令
自定义命令类（比如 SendDailyReport）写完后没出现在 php artisan list 里，90% 是注册问题，不是代码写错了：
- Laravel 不自动扫描
app/Console/Commands/下的所有类 —— 除非你用的是 Laravel 10+ 且满足自动发现条件（命名空间为App\Console\Commands、PSR-4 兼容、未被composer.json的autoload-dev排除） - 最稳妥的做法：打开
app/Console/Kernel.php，把类加到$commands数组里：\App\Console\Commands\SendDailyReport::class - 改完
Kernel.php后，如果之前运行过php artisan config:cache，得先php artisan config:clear再试 - 检查生成的类是否继承
Illuminate\Console\Command，且$signature属性是字符串（不能是 null 或空格开头）
$signature 参数和选项写法容易出错的地方
$signature 看似只是个字符串，但空格、冒号、问号位置错一个，参数就取不到，help 也不显示描述：
- 必填参数：
{user}→ 用$this->argument('user')取值 - 可选参数：
{user?}→$this->argument('user')返回null（没传时） - 带默认值的可选参数：
{user? : john}→ 注意冒号前后必须有空格，否则会被当作文本字面量 - 布尔选项：
{--queue}→$this->option('queue')返回true或false - 带值的选项：
{--path=}→ 等号不能省，调用时写--path=storage/logs，写成--path storage/logs就取不到
自定义命令中交互与输出的实用写法
别只靠 echo 或 var_dump，Artisan 提供了语义化 I/O 方法，既清晰又适配不同终端：
- 提问用户：
$this->ask('Enter email')、$this->confirm('Continue?')、$this->choice('Choose env', ['local', 'staging'], 0) - 输出状态：
$this->info('Done.')（绿色）、$this->warn('Deprecated')（黄色）、$this->error('Failed!')（红色） - 长文本提示可用
$this->line('...')，避免被当成命令结果截断 - 如果命令逻辑复杂，优先把业务抽到服务类里，
handle()只做调度和 I/O，方便测试和复用
真正卡住人的往往不是语法，而是路径、注册、缓存这三关；$signature 的空格和等号这种细节，也常因复制粘贴或 IDE 自动格式化被悄悄破坏。跑不通时，先 ls、再 config:clear、最后盯一眼冒号前后有没有空格。
