Laravel Artisan 命令需在项目根目录下通过 php artisan 执行，支持内置命令、自定义命令及交互式 TUI 工具；执行失败时应检查路径、命名空间、$signature 格式并刷新自动加载。
如果您在 Laravel 项目中需要执行代码生成、数据库操作或环境管理等任务，但尚未掌握命令行工具的调用方式，则可能是由于未正确启动 Artisan 或未在项目根目录下运行命令。以下是使用 Laravel Artisan 命令行工具的具体方法：
一、确认 Artisan 可用性并查看全部命令
Artisan 是 Laravel 内置的命令行接口，依赖于项目根目录下的 php artisan 可执行文件。运行前必须确保当前终端工作路径为 Laravel 项目根目录（即包含 artisan 文件的目录），否则将提示“command not found”或“no such file or directory”。
1、打开终端，切换至 Laravel 项目根目录：cd /path/to/your/laravel/project
2、执行命令列出所有已注册的 Artisan 命令：php artisan list
3、若需查看某条命令的详细用法与参数说明，运行：php artisan help [command]，例如 php artisan help make:controller
二、执行常用内置命令
Artisan 提供大量开箱即用的命令，覆盖开发全流程。每条命令均支持选项与参数，其结构遵循统一命名规范（如 make:model、migrate），便于识别功能类别。
1、生成 Eloquent 模型类：php artisan make:model Post
2、生成资源控制器（含 CRUD 方法）：php artisan make:controller PostController --resource
3、创建数据库迁移文件：php artisan make:migration create_posts_table
4、执行数据库迁移：php artisan migrate
5、清空应用缓存：php artisan cache:clear
6、重置配置缓存：php artisan config:clear
三、使用交互式 TUI 界面简化操作
对于不熟悉命令语法或希望避免拼写错误的开发者，可借助第三方交互式终端界面工具 artisan-tui，它将所有 Artisan 命令以可视化菜单形式呈现，自动引导参数输入，降低 CLI 使用门槛。
1、在开发环境中安装该工具：composer require --dev artisan-tui
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
2、安装完成后，在项目根目录执行：php artisan tui
3、使用方向键高亮选择目标命令（如 make:controller），按回车确认
4、根据提示依次输入控制器名称、是否启用资源模式等字段，工具将自动生成并执行完整命令
四、运行自定义 Artisan 命令
自定义命令需满足三个前提：类文件位于 app/Console/Commands/ 目录、继承 Illuminate\Console\Command、定义有效的 $signature 属性。Laravel 8+ 默认启用自动发现机制，无需手动注册；旧版本则需在 app/Console/Kernel.php 的 $commands 数组中显式添加。
1、生成自定义命令骨架：php artisan make:command SendDailyReport
2、编辑生成的文件 app/Console/Commands/SendDailyReport.php，设置 $signature = 'report:send {user}'; 与 $description = 'Send daily report to specified user';
3、在 handle() 方法中编写业务逻辑，例如调用 Eloquent 查询或发送邮件
4、运行命令验证：php artisan report:send admin
五、调试 Artisan 命令执行失败问题
当执行自定义或内置命令时报错 “Command is not defined”，通常并非代码逻辑错误，而是命令未被框架加载或解析。核心排查点集中在自动加载机制、命名空间声明与签名格式是否合规。
1、检查命令类是否位于 app/Console/Commands/ 下，且命名空间为 App\Console\Commands
2、确认 $signature 属性值非空、不含空格及非法字符（如 send:weekly-report 合法，send: weekly report 非法）
3、运行 composer dump-autoload 强制刷新自动加载映射（尤其在移动文件或修改命名空间后）
4、执行 php artisan list，观察目标命令是否出现在输出列表中；未出现即表示注册失败
