MessagePack 序列化完全指南

MessagePack 序列化完全指南 / The Complete Guide to MessagePack Serialization

一套由浅入深的 MessagePack 二进制序列化协议完整教程。 A comprehensive MessagePack binary serialization protocol tutorial, from shallow to deep.

目录 / Table of Contents

什么是 MessagePack？ / What is MessagePack?

MessagePack（简称 msgpack）是一种高效的二进制序列化格式（Binary Serialization Format），能够在保持跨语言、跨平台互操作性的同时，比 JSON 更小、更快。

MessagePack (abbreviated as msgpack) is an efficient binary serialization format that is smaller and faster than JSON while maintaining cross-language, cross-platform interoperability.

核心特性 / Core Features:

适用场景 / When to Use

与其他格式对比 / Comparison with Other Formats

阅读建议 / How to Read

• 初学者 / Beginners: 从第 1 章开始，按顺序阅读 / Start from Chapter 1, read in order.
• 有经验者 / Experienced: 直接跳到你使用的语言章节 / Jump to your language chapter.
• 架构师 / Architects: 重点阅读第 1、2、8、10 章 / Focus on Chapters 1, 2, 8, 10.

每章结构 / Chapter Structure:

• 📖 概念 — 核心知识点 / Concepts — core knowledge
• 💻 代码 — 多语言示例 / Code — multi-language examples
• ⚠️ 注意事项 — 常见陷阱 / Pitfalls — common traps
• 🔗 扩展阅读 — 深入资料 / Further reading — deep dive

快速开始 / Quick Start

如果你已经了解 MessagePack，选择你的语言直接开始：

If you already know MessagePack, pick your language and get started:

# Python Quick Start
import msgpack

data = {"name": "Alice", "scores": [95, 87, 92]}
packed = msgpack.packb(data)        # 序列化 / Serialize
unpacked = msgpack.unpackb(packed)   # 反序列化 / Deserialize
print(unpacked)  # {'name': b'Alice', 'scores': [95, 87, 92]}

// JavaScript Quick Start
import { encode, decode } from "@msgpack/msgpack";

const data = { name: "Alice", scores: [95, 87, 92] };
const encoded = encode(data);   // 序列化 / Serialize
const decoded = decode(encoded); // 反序列化 / Deserialize
console.log(decoded); // { name: "Alice", scores: [95, 87, 92] }

📝 版本说明 / Version Note: 本教程基于 MessagePack 规范版本 5（Revision 5），各语言库的 API 以 2025 年最新稳定版为准。

This tutorial is based on MessagePack Specification Revision 5. Language library APIs reflect the latest stable versions as of 2025.