影子属性是EF Core中仅存在于模型和数据库、不由实体类定义的属性，用于存储审计字段、外键等，需通过Fluent API配置，读写依赖ChangeTracker。
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—— 建议显式命名避免歧义
基本上就这些。不复杂，但容易忽略写法和生命周期限制。
