OsmSharp是C#中唯一成熟支持PBF流式解析的库，推荐用OsmStreamSource+OsmStreamTarget流式处理、启用includeTags:true、WGS84坐标单位为度；XML解析需跳过无关节点防OOM；过滤应在流式读取时完成，地理裁剪PBF用WithBoundingBox()，写入用OsmStreamTarget确保格式合规。
用 OsmSharp 读取 PBF 文件最省事
OSM 原始数据分 XML（.osm）和二进制 PBF（.osm.pbf）两种，PBF 是主流发布格式，体积小、解析快。C# 生态里，OsmSharp 是目前唯一成熟支持 PBF 流式解析的开源库，别折腾 XmlReader 手撕大 XML —— 内存爆、速度慢、节点嵌套深容易栈溢出。
实操建议：
- 用 NuGet 安装
OsmSharp（注意选官方包OsmSharp，不是旧版OsmSharp.Core） - 优先走流式处理：
OsmStreamSource+OsmStreamTarget，避免全量加载到内存 - PBF 解析默认不带标签（
tags），需显式启用：构造PbfStreamSource时传includeTags: true - 坐标是 WGS84 经纬度（
double），单位是度，不是米 —— 别直接拿去算距离
XmlReader 解析 .osm 文件要防内存炸
小范围数据（比如一个街区导出的 .osm）可用 XmlReader 手动遍历，但必须跳过无关节点、边、关系里的完整子树，否则极易 OOM。XML 没压缩，10MB 的 .osm 可能撑爆几百 MB 内存。
常见错误现象：
- 用
XDocument.Load()直接加载 —— 瞬间卡死或OutOfMemoryException - 在
StartElement里无条件读取所有node子元素（如Tag），导致深度递归 - 把全部
way的nd节点 ID 缓存成List<long></long>再查 —— 实际应边读边建索引
正确做法：
- 只监听
node、way、relation三级开始标签，其余用ReadToNextSibling()跳过 - 每个
node提取id、lat、lon和必要tag后立即处理，不缓存整棵树 - 若需拓扑（如路网连通性），用
Dictionary<long node></long>按需查，但限制缓存大小（比如只存最近 10 万节点）
过滤和投影：别在解析后才想“我要某城市道路”
OSM 数据全球一份，原始文件含所有类型要素。等全量解析完再 .Where(x => x.Tags.ContainsKey("highway"))，既浪费 CPU 又拖慢 IO —— 特别是 PBF，解压+解析本就耗时。
性能关键点：
- 用
OsmSharp的Filter功能，在流式读取时就丢弃不需要的元素：new OsmStreamFilter().Add(new TagFilter(true, "highway", null)) - 地理范围裁剪必须在解析前做：PBF 支持按 bbox 预过滤（需用
OsmSharp的PbfStreamSource.WithBoundingBox()），XML 则只能靠外部工具（如osmium extract）先切片 - WGS84 坐标转 Web Mercator（EPSG:3857）用
Math.Log(Math.Tan(...))公式即可，别调用重型 GIS 库；但注意极地附近会发散，实际只用于可视化时再转
写入 OSM 数据：别手动拼 XML 字符串
生成 .osm 文件或上传数据时，手写 XML 容易漏转义（比如 tag value="a & b" 不转义会解析失败）、属性顺序错乱、缺少命名空间声明，导致 OSM 编辑器拒绝导入。
可靠方案：
- 用
OsmSharp的OsmStreamTarget系列（如OsmXmlStreamTarget）生成标准格式，它自动处理命名空间、转义、缩进 - 写 PBF 必须用
OsmPbfStreamTarget，且输入数据需严格按 OSM 模型结构（Node、Way、Relation分开送入） - 时间戳字段（
timestamp）必须是 ISO 8601 格式（"2024-05-20T12:00:00Z"），不能用本地时区字符串，否则 OSM API 拒绝接收
真正麻烦的是关系（Relation）里的成员角色（role）和循环引用 —— 比如一个行政区划包含多个 way，而这些 way 又被其他 relation 引用。解析时得自己维护 ID 映射表，写入时更要确保成员先于关系出现。这点很容易被忽略，一跑就报 “member not found” 错误。
