使用 php artisan make:command 生成命令骨架，类需继承 Illuminate\Console\Command 并置于 app/Console/Commands/，正确实现 handle() 方法；交互用 $this->ask() 等封装方法，输出用 $this->info() 等，返回整数；依赖可构造注入，事务需手动包裹，队列需 dispatch job。
怎么生成一个可运行的自定义 Artisan 命令
直接用 php artisan make:command 生成骨架，它会自动注册到命令列表里，不用手动加服务提供者或配置文件。
常见错误是手写类但没继承 Illuminate\Console\Command，或者忘了在 handle() 方法里写逻辑——这时候命令能列出来，但执行就报错“Call to undefined method handle”。
- 命令类必须放在
app/Console/Commands/目录下（Laravel 9+ 默认路径） - 类名需符合 PSR-4，且文件名和类名一致（如
SendWeeklyReport→SendWeeklyReport.php） - 生成后记得检查
$signature属性是否合理，比如含参数时要写成report:send {user?} {--force}
如何在命令里安全读取用户输入和选项
别直接用 readline() 或 fgets()，Artisan 提供了封装好的交互方法，既兼容 Windows 又支持测试模拟。
典型陷阱是把 $this->argument('name') 和 $this->option('force') 混用，前者对应位置参数（如 php artisan report:send john），后者对应带 -- 的开关（如 --force）。
-
$this->ask('请输入邮箱？')用于必填文本输入 -
$this->confirm('确定要删除？')返回布尔值，适合 yes/no 场景 -
$this->anticipate('选个环境', ['local', 'staging', 'prod'])支持 Tab 补全 - 所有交互方法都支持
null默认值，比如$this->ask('端口', '8000')
为什么命令执行完没输出、或者输出乱码
核心原因是用了 echo 或 var_dump()，而不是 Artisan 推荐的输出方法。这些原始输出绕过 Laravel 的输出格式控制，会导致颜色失效、换行错乱、测试无法断言。
另一个常见问题是命令返回了非整数（比如 return 'done'），Artisan 要求 handle() 必须返回 int：0 表示成功，非 0 表示失败（Unix 传统）。
- 用
$this->info('✅ 已完成')输出绿色文字 - 用
$this->error('❌ 文件不存在')输出红色并终止 - 用
$this->line('普通文本，无样式')避免颜色干扰日志采集 - 调试时别用
dd()，改用$this->comment(json_encode($data))
怎么让命令支持队列、数据库事务或依赖注入
Artisan 命令本身就是容器解析出来的实例，所以可以直接在构造函数里类型提示任何绑定的服务，包括 Mailer、Redis、甚至自定义接口。
容易忽略的是数据库事务——命令默认不在事务中，如果想整个命令回滚，得手动 wrap：DB::transaction(fn () => $this->handleLogic())；而队列则需要额外处理：命令本身不能被推到队列，但可以在里面 dispatch 其他 job。
- 依赖注入完全合法：
public function __construct(MailManager $mailer) - 模型查询没问题，但注意长命令可能超时，建议加
set_time_limit(0)（仅 CLI 环境有效） - 不要在
handle()里调用exit()或die()，会跳过事件监听和清理逻辑 - 如果命令要跑很久，考虑加进度条：
$bar = $this->output->createProgressBar($total)
真正麻烦的是跨环境行为差异：本地开发时数据库连接正常，但线上可能因权限或网络策略失败；还有命令里用到的配置项（比如 config('mail.default')）在队列 job 中可能不是最新值——这类问题不会报错，只会静默出错。
