Geometry 总是 null 是因为 GeoJSON.Net 的 Geometry.Load 只解析纯几何对象，不支持顶层为 FeatureCollection 的完整文件；应改用 FeatureCollection.Load 后遍历 Features 获取 Geometry。
用 GeoJSON.Net 读取 .geojson 文件时，为什么 Geometry 总是 null？
因为 GeoJSON 规范要求顶层必须是 FeatureCollection、Feature 或几何对象之一，而 GeoJSON.Net 的 Geometry.Load 只认纯几何（如 { "type": "Point", ... }），不处理带 features 数组的完整文件。
- 正确做法：用
FeatureCollection.Load读整个文件，再遍历Features获取每个Feature.Geometry - 常见错误：直接对完整 GeoJSON 文件调用
Geometry.Load→ 抛出JsonReaderException或返回null - 注意字段名大小写：
FeatureCollection的属性是Features（首字母大写），不是features；若原始 JSON 是小写，需配合JsonSerializerSettings.ContractResolver = new DefaultContractResolver { NamingStrategy = new SnakeCaseNamingStrategy() }
写入 GeoJSON 时，Feature.Properties 里的中文或嵌套对象丢失怎么办？
GeoJSON.Net 默认用 Newtonsoft.Json 序列化 Properties，但它的 IDictionary<string object></string> 对泛型支持弱，遇到 DateTime、自定义类或未标记 [JsonObject] 的类型会跳过或转成空对象。
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
- 安全写法：把所有值先转成基础类型（
string、int、double、bool）或JToken，再塞进Properties - 避免直接塞
new { Name = "杭州", Code = 3301 }—— 匿名类型在序列化时可能被忽略 - 若必须存复杂结构，手动用
JObject.FromObject(...)转一次再赋值给Properties["meta"]
在 WinForms/WPF 中显示 GeoJSON 点线面，为什么 MapControl 加载后啥也不画？
绝大多数 .NET 地图控件（如 DotSpatial、ThinkGeo 或 Microsoft.Maps 封装）不原生支持 GeoJSON 字符串，需要先转换为对应 SDK 的几何类型（如 DotSpatial.Topology.Geometry 或 Microsoft.Maps.MapControl.WPF.LocationCollection）。
- 点（
Point）→ 提取Coordinates数组，转成Location或Coordinate - 线（
LineString）→ 把Coordinates每项转Location，再构造成LocationCollection或LineString - 面（
Polygon）→ 注意外环和内环顺序，DotSpatial要求外环逆时针、内环顺时针，否则渲染为空 - 别忘了坐标系：GeoJSON 默认是 WGS84（EPSG:4326），若地图底图用 Web Mercator（EPSG:3857），得做投影转换，否则位置严重偏移
用 System.Text.Json 替换 Newtonsoft.Json 后，GeoJSON.Net 序列化失败
GeoJSON.Net 目前（v1.0.35）仍强依赖 Newtonsoft.Json，其 IGeometry 和 IFeature 接口的序列化逻辑写死在 JsonConverter 里，System.Text.Json 无法识别这些自定义转换器。
- 硬切不可行：哪怕你用
JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter())，也无法覆盖Geometry类型的序列化行为 - 折中方案：保留
Newtonsoft.Json专用于 GeoJSON 部分，其他业务逻辑用System.Text.Json，二者共存无冲突 - 如果项目已禁用
Newtonsoft.Json，只能改用NetTopologySuite.IO.GeoJSON（它支持System.Text.Json且 API 更现代，但需手动映射Feature到IGeometry）
FeatureCollection 必须有 Features 数组、以及 WGS84 坐标系假设，这三点在调试时最容易被当成“数据有问题”而反复折腾。 
