EF Core 7 原生支持 JSON 列映射，推荐用 Owned Entity + ToJson() 方式声明和配置，支持 LINQ 点语法查询、局部更新及索引优化。
EF Core 7 原生支持 JSON 列映射，不用手动序列化/反序列化，也不用写自定义转换器——只要配置得当，就能像操作普通属性一样读写、查询、更新 JSON 字段。
实体类里怎么声明 JSON 字段
推荐用 Owned Entity + ToJson() 方式，语义清晰、结构可控。比如地址信息不单独建表，就存成一个 JSON 字段：
public class Customer
{
public int Id { get; set; }
public string Name { get; set; } = "";
public Address Address { get; set; } = null!;
}
public class Address
{
public string Line1 { get; set; } = "";
public string Line2 { get; set; } = "";
}
DbContext 中怎么配置为 JSON 列
在 OnModelCreating 里启用 OwnsOne(...).ToJson()：
modelBuilder.Entity
.OwnsOne(e => e.Address, addressBuilder =>
{
addressBuilder.ToJson();
addressBuilder.Property(a => a.Line1).HasMaxLength(256);
addressBuilder.Property(a => a.Line2).HasMaxLength(256);
});
- 数据库中只生成一个
AddressTEXT 或 JSON 类型字段（MySQL/PostgreSQL 自动识别） - EF Core 会自动用
JSON_MODIFY（SQL Server）或JSON_SET（MySQL）做局部更新，不是整字段覆盖 - 嵌套多层也只需顶层调用
.ToJson()，子对象自动纳入
怎么查询 JSON 字段里的值
直接用点语法写 LINQ，EF Core 会翻译成原生 JSON 函数：
var customers = await context.Customers
.Where(c => c.Address.Line1 == "Beijing Road")
.ToListAsync();
- SQL Server → 翻译为
JSON_VALUE(Address, '$.Line1') - MySQL → 翻译为
JSON_EXTRACT(Address, '$.Line1') - 支持
Contains、StartsWith、OrderBy等常见操作 - 如需模糊匹配或复杂条件，可用
EF.Functions.JsonValue手动指定路径
性能优化关键点
JSON 查询快不快，不取决于 EF Core，而在于数据库是否能走索引：
- 对高频查询的 JSON 字段，在数据库建 生成列（Generated Column）+ 普通索引，例如 MySQL：
ALTER TABLE Customer ADD COLUMN addr_line1 VARCHAR(256) STORED AS (JSON_UNQUOTE(JSON_EXTRACT(Address, '$.Line1')));
CREATE INDEX IX_Customer_addr_line1 ON Customer(addr_line1); - 避免在
WHERE中大量使用JSON_EXTRACT，尤其跨多行计算时性能陡降 - 更新时优先用属性赋值（
c.Address.Line1 = "new"），EF Core 自动生成局部修改语句，比整字段重设更安全、更高效
基本上就这些。配置一次，后续增删改查都和普通属性一样自然，不用碰 JSON 字符串。
