EF Core 影子属性（Shadow Properties）不是你实体类里定义的字段，而是只存在于 EF Core 模型和数据库中、由框架在背后管理的属性。它不占实体类代码空间，却能参与查询、排序、保存和变更跟踪——特别适合存审计字段（如 LastUpdated、CreatedBy）、外键值或临时业务标记。
什么时候该用影子属性
以下情况直接考虑影子属性：
数据库表里有LastModified列，但你不想把它加进
Blog类——避免污染领域模型 两个实体有导航关系（比如
Post→
Blog），但
Post类里没写
BlogId字段，EF 会自动创建影子外键（如
BlogId） 需要对某列做全局排序或过滤（比如按
CreatedAt倒序查），又不希望每个 DTO 或 ViewModel 都暴露它 做软删除时，
IsDeleted存在数据库但不暴露给上层业务逻辑层
怎么定义影子属性
只能通过 Fluent API 在
OnModelCreating中配置，不能用数据注解（Data Annotations）。
例如为
Blog添加
LastUpdated影子属性：
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<Blog>()
.Property<DateTime>("LastUpdated") // 名字是字符串，类型是泛型参数
.HasDefaultValueSql("GETUTCDATE()"); // 可选：设默认值（SQL Server）
}
注意：
"LastUpdated"是纯字符串名，不校验是否在类中存在；类型必须匹配数据库列的实际类型。
怎么读写影子属性的值
影子属性不能通过
blog.LastUpdated访问，必须走 EF 的专用 API： 写入值（新增或更新时）：
context.Entry(blog).Property("LastUpdated").CurrentValue = DateTime.UtcNow;
查询中使用（生成 SQL 的 WHERE / ORDER BY）：var blogs = context.Blogs.OrderBy(b => EF.Property<datetime>(b, "LastUpdated"));</datetime>加载后读取当前值：
var lastTime = context.Entry(blog).Property("LastUpdated").CurrentValue;
所有操作都依赖
ChangeTracker，所以实体必须已附加（tracked）到上下文。
影子属性的常见陷阱
用起来方便，但几个细节容易踩坑：
迁移生成时，EF 会自动把影子属性加进Up(MigrationBuilder)，但如果你删了配置，它不会自动删列——得手动处理 不能用于导航属性初始化（比如
Include不支持影子属性） JSON 列、计算列、触发器维护的字段，如果要用影子属性映射，需确保类型兼容且无冲突 外键影子属性命名有约定：若
Post有
Blog导航属性，EF 默认建
BlogId；若没导航属性，则可能叫
BlogBlogId—— 建议显式命名避免歧义
基本上就这些。不复杂，但容易忽略写法和生命周期限制。
