EF Core 的 [NotMapped] 注解用来告诉框架:这个属性不参与数据库映射,不会生成对应列,也不会在查询或保存时读写数据库。它最常用于计算属性、临时字段、前端展示用的组合值,或者纯内存中使用的辅助数据。
什么时候必须加 [NotMapped]?
只要属性不对应数据库中的任何一列,又确实定义在实体类里(比如为了方便前端展示或业务逻辑),就必须标记
[NotMapped],否则 EF Core 会尝试为它建列,导致迁移失败或运行时报错。 只读计算属性(如
public string FullName => FirstName + " " + LastName;) 临时状态字段(如
public bool IsSelected { get; set; },仅用于页面勾选)
敏感但不落库的数据(如 public string TempToken { get; set; })
与外键同名但非导航用途的普通字段(避免被误判为关联)
怎么写?基础用法很简单
确保引入命名空间:
using System.ComponentModel.DataAnnotations.Schema;
然后直接加在属性上:
[NotMapped]
public string DisplayCode => $"{GoodsName.Substring(0, 1)}:{Location}";
注意:该属性可以是自动属性、只读属性(只有
get)、或完整属性(
get+
set),EF Core 都会跳过——前提是加了
[NotMapped]。
不加的话,哪怕只有
get,EF Core 也可能因其他配置(如 Fluent API 中未忽略)而报错;加了就明确、安全、无歧义。
类级别也能用 [NotMapped]
如果整个类只是做中间计算或 DTO 用途,不希望它在数据库里有任何表,可以直接标在类上:
[NotMapped]
public class CalculationResult
{
public string Description { get; set; }
public decimal Value { get; set; }
}
这样 EF Core 在构建模型时会完全跳过这个类型,不会为它生成迁移,也不会出现在
DbContext的
DbSet中。
替代方案:Fluent API 忽略属性
如果你倾向把映射逻辑集中到
OnModelCreating里,也可以不用注解:
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<Goods>()
.Ignore(g => g.GoodsCode);
}
这种方式适合团队规范要求“注解只管校验,映射全走 Fluent”,也方便统一管理忽略项。但日常开发中,
[NotMapped]更直观、更易维护。
基本上就这些。用对地方,不漏加,不乱加——EF Core 就不会为你的“假字段”建真列。
