Nova Resource是模型的管理配置层，需置于app/Nova目录下、类名与文件名一致并继承Nova\Resource，实现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 - 若模型是
App\Models\Customer，Resource 类仍应命名为Customer，放在app/Nova/Customer.php - 类需继承
Nova\Resource，并实现model()方法返回对应模型类名字符串
namespace App\Nova;
use Laravel\Nova\Resource;
use App\Models\Customer;
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([
\App\Nova\User::class,
\App\Nova\Post::class,
\App\Nova\Comment::class,
]);
}
漏掉一个类，对应菜单就消失。另外，如果用了多租户或权限隔离，还要检查 canSee() 方法是否误返回 false —— 它会在菜单渲染前被调用，静默过滤掉整个资源入口。
