CBOR / MessagePack Codec

JSON Input

Educational tool: This simulates how CBOR (RFC 8949) binary encoding represents JSON data. The hex column shows what the encoded binary bytes would look like. Unlike JSON (text-based), binary formats encode types, lengths, and values in compact byte sequences.

技术详情

CBOR / MessagePack 转换器的工作原理

工具功能

CBOR / MessagePack 转换器可在 JSON 与二进制序列化格式（CBOR 和 MessagePack）之间互相转换。CBOR（Concise Binary Object Representation）和 MessagePack 都是高效的二进制数据格式，旨在替代 JSON 用于资源受限环境（如 IoT 设备、移动应用）中的数据交换。该工具帮助开发者可视化二进制编码数据或为二进制序列化准备 JSON 数据。

常见开发者使用场景

二进制序列化在性能敏感场景中广泛应用：物联网（IoT）设备使用 CBOR 高效传输传感器数据、移动应用使用 MessagePack 减少 API 响应体积以节省流量、微服务间通信中替换 JSON 以降低解析开销、浏览器中的 WebSocket 消息使用 MessagePack 减小传输大小、以及 Redis 等数据库使用 MessagePack 序列化缓存值。

如果需要处理其他序列化格式，可以参考 JSON-YAML 转换器和 Protobuf 编解码器。YAML-TOML 转换器提供配置文件格式转换。Base64 编解码器可用于编码二进制输出。

技术原理/相关概念

CBOR 和 MessagePack 都使用类型前缀 + 数据体的编码方式。MessagePack 使用短小的类型标识符：正整数（0xxxxxxx）、字符串（101xxxxx + 长度前缀）、数组（1001xxxx + 元素数）、映射（1000xxxx + 键值对数）。CBOR 在 MessagePack 基础上扩展了更多类型（如大整数、十进制浮点数、日期时间标签），并增加了自描述性。两种格式都比 JSON 更紧凑——对于包含大量数字的数据，大小可减少 30-50%。

常见陷阱与注意事项

类型差异：MessagePack 和 CBOR 的类型系统与 JSON 不完全对应。如 MessagePack 区分 int 和 uint，JSON 只有 number；CBOR 支持二进制数据和日期标签，JSON 不支持。
浮点精度：往返转换（JSON → CBOR/MessagePack → JSON）可能导致浮点数精度损失。
不可读：二进制格式不可直接阅读调试，需要专门的查看器或转换工具。
兼容性：不同语言的 CBOR/MessagePack 库可能在类型映射上有细微差异，确保发送端和接收端使用一致的库版本。

何时使用此工具而非代码

在调试二进制序列化数据、探索格式特性或快速验证数据转换效果时使用此工具。适合开发者在选择序列化方案时进行对比测试。对于生产环境，应使用编程语言的序列化库（如 cbor-js、msgpack-lite、serde_cbor），它们提供流式处理、更好的性能和类型安全。此工具主要作为格式理解和数据调试的辅助手段。