直接手写c++解析.osm.pbf不可取，因其是protocol buffer+ zlib + varint + 字符串表的嵌套结构；应使用最新版libosmium，通过osmium::io::reader与自定义handler流式处理，注意校验文件完整性并捕获异常。
直接手写 C++ 解析 .osm.pbf 文件不可取——它不是普通二进制，而是 Protocol Buffer 封装 + zlib 压缩 + 变长整数（varint/zigzag）+ 外部字符串表（stringtable）的嵌套结构。你看到的每个 PrimitiveBlock 里可能含多个 PrimitiveGroup，而每个 group 又按 type（node/way/relation）分片存储，坐标还做了 delta 编码。真要从零啃，两周写不完一个能跑通的 read_node()。
用 libosmium 是唯一靠谱的生产级选择
libosmium 是目前 C++ 生态中唯一被 OSM 社区广泛验证、持续维护、支持增量流式处理的 PBF 解析库。它不依赖 protoc 生成代码，也不把整个文件 load 到内存，而是靠 osmium::io::Reader + 自定义 osmium::handler::Handler 组合实现低内存开销遍历。
- 必须从 GitHub 主仓库 拉最新源码编译，系统包管理器（如 apt/yum）里的版本普遍滞后 2 年以上，缺对新版 PBF 块结构的支持
-
osmium::io::Reader构造时传入"pbf"显式指定格式，否则某些带 BOM 或混合头的文件会静默失败 - 自定义 handler 必须继承
osmium::handler::Handler，并重载node()/way()/relation()；别漏掉osmium::area::Assembler——relation 转面（如湖泊、行政区）需额外调用它，否则relation对象里只有成员引用，没有实际几何 - 所有回调函数接收的是 const ref（如
const osmium::Node&），不要试图在 handler 里深拷贝或长期持有指针——Reader每次回调后会复用内部 buffer
osmium::io::Reader 的 open 模式和错误信号很隐蔽
osmium::io::Reader 默认以 osmium::io::File::compression::auto 推断压缩类型，但 PBF 文件头部并不包含 zlib magic，它靠的是 Blob 结构体里的 raw_size 和 raw 字段是否匹配来判断是否需要解压。一旦文件被意外截断或校验失败，Reader 不抛异常，而是静默跳过后续 block，直到 reader.read() 返回空对象。
- 务必在循环读取前检查
reader.file_size()是否非零，且与stat()获取的实际文件大小一致——部分镜像站（如 Geofabrik）偶尔发布末尾缺失 CRC 的 pbf - 用
try { ... } catch (const std::exception& e) { warn() 包裹 <code>reader.read()调用，libosmium 在解析失败时会 throwosmium::pbf_error或std::runtime_error，但不会覆盖 errno - 不要依赖
reader.eof()判断结束——它只反映底层 stream 是否到尾，而 PBF 可能含 padding bytes；正确做法是循环调用reader.read()直到返回osmium::memory::Buffer{}
坐标还原和 relation 面构建是两个高频翻车点
PBF 中 node 的经纬度不是原始 double，而是以 int64_t 存储的 scaled 值（默认 scale = 1e9），且 way/relation 中的节点 ID 是 delta 编码。relation 构建面更麻烦：它本身不含 geometry，只存 member 引用，必须用 osmium::area::Assembler 手动拼接闭合环，且要处理 inner/outer role、多部件、自相交等拓扑情况。
- 还原坐标用
node.location().lon() / 1000000000.0，别硬写/ 1e9——浮点除法在某些 ARM 架构上精度丢失严重 - 遍历 way 时，用
way.nodes().size()拿节点数，别用way.nodes().end() - way.nodes().begin()，迭代器差值在 debug 模式下可能触发断言 - 构建 area 前先调用
osmium::area::MultipolygonManager处理 relation，它会自动识别type=multipolygon标签，并按 role 分组 outer/inner；没这个步骤，Assembler会把 relation 当作普通线处理 - area 构建失败时，
Assembler返回空osmium::Area，但不会报错——需检查area.from_way()或area.from_relation()的返回布尔值
真正难的不是读出数据，而是理解 PBF 的“懒加载”本质：它不保证顺序、不保证完整性、不承诺坐标精度恒定。哪怕同一个 asia-latest.osm.pbf，不同版本 libosmium 解析出的 relation 面顶点数都可能差几个——因为字符串表索引、delta base、block 边界都会影响最终结果。动手前先跑通官方 example/dump_nodes.cpp，再改 handler，比对着 spec 硬推快十倍。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
