php artisan make:controller 至少需指定控制器名，如 php artisan make:controller usercontroller；支持 --invokable、--resource、--api 等参数定制功能，子目录路径可直接写入命令；默认继承 app\http\controllers\controller，不自动注入依赖，命名空间与文件名须严格匹配，错误“class does not exist”多因大小写或自动加载未更新。
php artisan make:controller 命令怎么用
直接运行 php artisan make:controller 会报错，因为它至少需要一个控制器名参数。最简可用写法是：php artisan make:controller UserController —— 这会在 app/Http/Controllers/ 下生成 UserController.php，默认不含任何方法。
- 加
--invokable参数生成单方法控制器（只有__invoke），适合 API 端点或简单路由 - 加
--resource生成带 7 个 REST 方法的控制器（index、create、store等），但不会自动注册路由，得自己配Route::resource() - 加
--api时会跳过create和edit这两个返回视图的方法，适合纯 API 场景 - 如果控制器要放在子目录，比如
Api/V1/PostController，命令里直接写全路径：php artisan make:controller Api/V1/PostController --api，Laravel 会自动建目录
生成的控制器为什么没继承 BaseController 或没注入依赖
Laravel 默认生成的控制器继承 App\Http\Controllers\Controller，而这个基类本身只做了基础初始化（如中间件绑定），不带任何业务逻辑或常用工具方法。它也不自动注入 Request 或其他服务——那是你写方法签名时手动声明的。
- 如果你习惯在构造函数里注入服务（比如
UserService），得自己补上public function __construct(UserService $service)和属性赋值，命令不会帮你加 - 想让所有控制器统一继承自定义基类（比如
App\Http\Controllers\BaseController），得改命令源码或用脚手架模板；更实际的做法是生成后手动改extends行 - 注意：Laravel 10+ 的默认控制器不再含
__construct()，哪怕你加了--resource，所以别指望它自动绑中间件——中间件得在路由定义里加，或者在控制器顶部用middleware()方法注册
“Class UserController does not exist” 错误怎么快速定位
这个错误不是控制器没生成，而是自动加载没生效。常见于：控制器文件名大小写不一致、命名空间写错、或没跑 composer dump-autoload。
- 检查文件名是否严格匹配类名：比如类是
UserController，文件必须叫UserController.php（不能是usercontroller.php或user_controller.php） - 打开生成的文件，确认
namespace是App\Http\Controllers（或你指定的子命名空间），且class名和文件名一致 - 如果用了子目录（如
Admin/DashboardController），命名空间必须是App\Http\Controllers\Admin，且use语句不能漏 - 开发中改完命名空间或移动文件后，建议顺手执行
composer dump-autoload -o，避免缓存干扰
什么时候不该用 make:controller
当控制器职责模糊、方法粒度太细、或只是临时调试用，硬套这个命令反而增加维护成本。
- API 中单个端点逻辑极简（比如只查一条记录并返回 JSON），直接在
routes/api.php里写闭包更轻量：Route::get('/health', fn() => response()->json(['status' => 'ok'])) - 已有控制器方法膨胀到 20+ 个，说明它该拆了——别再
make:controller新的，优先考虑提取 Service 类或 Policy 类 - 写测试时发现控制器里混了大量 DB 查询或第三方调用，这时候生成控制器只是把问题藏得更深；先抽离逻辑，再决定要不要新控制器
真正卡住人的往往不是命令会不会敲，而是没想清楚这个控制器到底承载哪块边界、谁来调用、生命周期多长。生成动作本身 5 秒就完，但命名、分层、依赖设计这些，得在敲回车前想明白。
