如何快速上手Laravel Nova搭建后台管理面板？ (Resource定义)

Nova Resource是模型的管理配置层，需置于app/Nova目录下、类名与文件名一致并继承NovaResource，实现model()方法；fields()中字段名须明确指定数据源，嵌套字段需配合with预加载，列表性能问题应通过重写indexQuery()和relatableQuery()解决。

Nova 的 Resource 不是 Eloquent 模型本身，而是模型的管理配置层——直接在 app/Nova 下新建类、继承 Resource、定义 fields() 和 cards() 就能立刻出现在 Nova 后台侧边栏。

Resource 类必须放在 app/Nova 目录下且命名匹配

Nova 通过命名空间和文件路径双重识别 Resource。默认只扫描 app/Nova，不支持子目录（除非手动注册）；类名必须与文件名一致，且首字母大写。比如：

• app/Nova/User.php → 类名必须是 User，不能叫 AdminUser
• 若模型是 AppModelsCustomer，Resource 类仍应命名为 Customer，放在 app/Nova/Customer.php
• 类需继承 NovaResource，并实现 model() 方法返回对应模型类名字符串

namespace AppNova;  use laravelNovaResource; use AppModelsCustomer;  class Customer extends Resource {     public static function model()     {         return Customer::class;     } }

fields() 里别直接用模型属性名当字段名

Nova 字段名默认映射数据库列，但很多场景需要脱钩：比如想显示关联模型的姓名而非 ID，或展示计算字段。此时不能写 Text::make('name') 就完事，得明确指定底层数据来源：

• 用 Text::make('Full Name', 'name') 表示前端显示 “Full Name”，但读取/写入模型的 name 属性
• 想显示关联字段？用 Text::make('Company Name', 'company.name') —— Nova 支持点号嵌套，前提是关系已定义且 eager loaded（见下一条）
• 自定义值？用闭包：Text::make('Status', function () { return $this->active ? 'Active' : 'Inactive'; })，但注意这字段不可编辑

列表页性能崩了？检查 relatableQuery() 和 indexQuery()

默认情况下，Nova 列表页会执行 Model::query()，不做任何预加载。一旦你在 fields() 里用了 'user.name' 这种嵌套字段，就会触发 N+1 查询。修复方式不是加 with()，而是重写两个查询方法：

• indexQuery() 控制列表页主查询，可在这里加 with('user', 'category')
• relatableQuery() 控制下拉选择、关联搜索等场景的可用数据范围，比如限制用户只能看到自己创建的标签：return $query->where('user_id', request()->user()->id);
• 千万别在 fields() 里做数据库查询——字段定义阶段模型实例尚未加载完整，$this 可能为空或不包含关系

资源注册后没出现在侧边栏？确认 app/Providers/NovaServiceProvider.php 中的 resources()

Nova 默认通过扫描 app/Nova 自动注册，但一旦你修改过 NovaServiceProvider 的 resources() 方法（比如注释掉 parent::resources();），就必须显式列出所有 Resource：

protected function resources() {     Nova::resources([         AppNovaUser::class,         AppNovaPost::class,         AppNovaComment::class,     ]); }

漏掉一个类，对应菜单就消失。另外，如果用了多租户或权限隔离，还要检查 canSee() 方法是否误返回 false —— 它会在菜单渲染前被调用，静默过滤掉整个资源入口。