运行 php artisan make:controller PostController 默认只生成空类，不包含 index 等方法；需加 --resource 参数才能生成 REST 标准的 7 个方法，且必须手动在路由文件中注册 Route::resource('posts', PostController::class) 并正确引入命名空间。
直接用 php artisan make:controller 命令创建，但不加参数只生成空类——它不会自动带任何方法，也不能直接绑定资源路由。想开箱即用 REST 接口，必须加 --resource；想响应单个端点，得加 --invokable。
为什么运行了 make:controller 却找不到 index 方法？
因为默认行为就是只建一个空壳类。Laravel 不会猜测你要什么逻辑，php artisan make:controller PostController 生成的文件里只有命名空间、use 语句和空的 class 块。
- 要生成
index、show、store等 7 个标准方法，必须显式加--resource：php artisan make:controller PostController --resource - 加了
--resource后，方法名严格固定为index、create、store、show、edit、update、destroy——大小写敏感，不能写成Show或show_user，否则路由匹配失败 - 如果只是临时加个 API 状态页，用
--invokable更轻量：php artisan make:controller StatusController --invokable，它只生成一个__invoke()方法
资源控制器生成后为什么访问 /posts 返回 404？
因为 --resource 只负责生成 PHP 类文件，不碰路由定义。Laravel 不会自动把代码和 URL 连起来。
- 你必须手动在
routes/web.php或routes/api.php中注册：Route::resource('posts', PostController::class); - 如果漏了
use App\Http\Controllers\PostController;，或用了错误的命名空间（比如没加App\Http\Controllers\），也会报Class not found - 想只暴露部分动作，用
->only()或->except()：Route::resource('posts', PostController::class)->only(['index', 'show']); -
Route::resource()默认不带中间件，登录控制、权限检查都得自己加：->middleware('auth')或->middleware(['auth', 'can:update,Post'])
控制器方法参数绑定失败，$post 总是 null？
隐式模型绑定生效的前提是：路由参数名、方法参数名、类型提示类三者完全一致。
- 路由写成
/posts/{id}，方法签名是public function show(Post $post)→ 绑定失败，因为参数名$post和路由段{id}不匹配 - 正确写法是路由用
/posts/{post}，方法保持show(Post $post)；或者路由不动，方法改成show($id)并手动查库：Post::findOrFail($id) - 加了
--model=Post参数（如php artisan make:controller PostController --resource --model=Post）会自动生成带类型提示的方法签名，但依然要求路由参数名对齐 - 类型提示会触发额外一次数据库查询，高频接口要注意 N+1，必要时用
with()预加载关联数据
最容易被忽略的是：控制器文件名、类名、命名空间三者必须严格一致，错一个字母或大小写就加载失败；还有就是 composer dump-autoload 没跑，导致新生成的类不被识别——尤其在 Docker 或 CI 环境里很常见。
