EF Core 使用空间数据，核心是靠 NetTopologySuite（NTS） 提供几何类型支持，并配合数据库提供者的空间扩展包完成映射与查询。它不是开箱即用的功能，需要显式启用、正确配置类型和 SRID，否则会报错或行为异常。
安装对应数据库的 NetTopologySuite 扩展包
不同数据库需引用不同的空间扩展包，不能混用：
SQL Server：`Microsoft.EntityFrameworkCore.SqlServer.NetTopologySuite` PostgreSQL（PostGIS）：`Npgsql.EntityFrameworkCore.PostgreSQL.NetTopologySuite` SQLite（SpatiaLite）：`Microsoft.EntityFrameworkCore.Sqlite.NetTopologySuite` + `sqlite3` 原生库（macOS/Linux 需设DYLD_LIBRARY_PATH） MySQL（Pomelo）：`Pomelo.EntityFrameworkCore.MySql.NetTopologySuite`
同时必须安装基础 NTS 包：
NetTopologySuite，它是所有几何类型（
Point、
Polygon、
LineString等）的来源。
在 DbContext 中启用 NetTopologySuite
配置连接时，必须显式调用
UseNetTopologySuite()方法：
// SQL Server 示例 options.UseSqlServer(connectionString, x => x.UseNetTopologySuite()); // PostgreSQL 示例 options.UseNpgsql(connectionString, x => x.UseNetTopologySuite()); // SQLite 示例 options.UseSqlite(connectionString, x => x.UseNetTopologySuite());
注意：不加这一步，即使模型里用了
Point，EF Core 也会忽略空间能力，生成普通 BLOB 或字符串字段，查询也完全无法使用空间函数。
定义实体中的空间属性并指定 SRID
NTS 类型默认 SRID 为 0，但绝大多数地理场景（如 GPS、地图 API）要求明确使用 SRID 4326（WGS 84）：
在模型中用 Fluent API 显式声明：modelBuilder.Entity<Store>()
.Property(e => e.Location)
.HasSrid(4326); // 必须设置，否则距离计算、索引等可能出错
属性类型推荐使用 NTS 原生类：
public class Store
{
public int Id { get; set; }
public string Name { get; set; }
public NetTopologySuite.Geometries.Point Location { get; set; } // 不要用 string 或 byte[]
}
注意：坐标顺序是 X（经度）、Y（纬度），例如
new Point(113.4667, 22.2723) { SRID = 4326 } —— 这和前端常写的 [lat, lng] 顺序相反，容易填反。
执行空间查询（如“附近5公里的门店”）
EF Core 会把 NTS 方法自动翻译成数据库原生空间函数（如 SQL Server 的
STDistance、PostGIS 的
ST_DWithin）：
var current = new NetTopologySuite.Geometries.Point(113.4667, 22.2723) { SRID = 4326 };
var nearby = await context.Stores
.Where(s => s.Location.Distance(current) < 0.05) // 单位是“度”，非米！
.OrderBy(s => s.Location.Distance(current))
.Take(10)
.ToListAsync();
⚠️ 注意：
Distance()返回单位取决于 SRID 和数据库。对 4326，SQL Server 返回“米”，PostgreSQL 默认返回“米”（若用
ST_DWithin），但 SQLite/SpatiaLite 返回“度”——建议生产环境统一用
STDistance+ 索引，或在数据库层做单位转换。
更安全的做法是用数据库原生函数封装（如 SQL Server 的
STDistance）：
.Where(s => EF.Functions.STDistance(s.Location, current) < 5000) // 明确单位：米
基本上就这些。关键点就三个：装对包、启用 UseNetTopologySuite、设好 SRID 和坐标顺序。不复杂但容易忽略细节。
