msgpack提效需正确使用packb/unpackb、配对use_bin_type=True与raw=False、确保字典键为str、统一时间戳格式。直接替换JSON不自动提效，关键在规避类型陷阱与跨语言兼容问题。
msgpack 能在分布式系统中显著降低序列化开销，但直接替换 json 不等于自动提效——关键在于选对函数、配对参数、避开类型陷阱。
packb 和 unpackb 是默认首选，不是 dumps/loads
虽然 msgpack 提供了 dumps 和 loads 这两个与 json 同名的别名，但它们只是包装层，底层仍调用 packb 和 unpackb。实际使用中应直接调用后者，避免多一层封装带来的隐式开销和行为差异。
-
packb返回bytes，明确语义；dumps在旧版本中可能返回str（已弃用），容易引发编码混淆 -
unpackb默认返回bytes字符串键和值，加raw=False才转为str——这点必须显式声明，否则下游字典操作会因键类型不一致而报KeyError - 流式场景必须用
Unpacker，不能靠反复调unpackb，否则无法处理粘包或分块传输
use_bin_type=True 和 raw=False 必须配对使用
Python 3 中字符串和字节的区分比 JSON 严格得多。msgpack 默认把 str 编码为 UTF-8 字节串，但不标记为 binary 类型；而很多 Go 或 Rust 的 MessagePack 实现依赖 bin 类型标识来正确还原 bytes。
- 服务端用
packb(data, use_bin_type=True)→ 确保str和bytes都走 binary type - 客户端用
unpackb(packed, raw=False)→ 把 binary type 自动解为str，避免字节串污染业务逻辑 - 若两端不统一，常见错误是：Go 服务发来的
bin字段，在 Python 里被当成bytes，导致dict['key']失败
字典键只能是 str，嵌套结构要自查
msgpack 协议规定 map 的 key 必须是 string 类型，这比 JSON 更严格。Python 里看似合法的 {1: 'a', 'b': 2} 会被 packb 直接拒绝，报错 ValueError: can't serialize dict with non-string keys。
- 常见踩坑点：用
enum.IntEnum作键、用intID 做字典索引、从数据库读出的dict含数字键（如 SQLAlchemy 的row._mapping） - 解决方案不是硬转
str()，而是提前标准化：用{str(k): v for k, v in data.items()}或改用list+tuple结构 - 如果结构来自第三方库（如 Pandas DataFrame.to_dict()），注意其默认行为可能生成
int键，需预处理
跨语言通信时，时间戳和扩展类型要协商好
msgpack 支持 datetime，但默认不启用。Python 的 datetime 会被当作普通对象抛异常，除非显式注册扩展类型或用 datetime 模块转换。
立即学习“Python免费学习笔记（深入）”；
- 最稳妥做法：统一转成 Unix timestamp（
int或float），所有语言都原生支持 - 若必须传
datetime，服务端要用packb(data, datetime=True)（>=1.0.0），客户端对应加unpackb(..., timestamp=3)（不同版本参数名不同） - Go 的
msgpack库默认把 timestamp 当int64解，Python 若没设timestamp参数，unpackb会返回ExtType对象，不是datetime
