simplejson：Python JSON 处理的持久选择

simplejson 在 GitHub 上获得 1,712 Star。

它是 Python 标准库 json 模块的上游版本。从 Python 2.6 开始，标准库内置的 json 就源自 simplejson。但这个外部版本一直在独立演进，保持着更快的更新节奏和更多的功能。

对 Python 开发者来说，处理 JSON 是每天都在做的事。读取 API 响应、写入配置文件、序列化日志数据，处处都是 JSON。大多数人的选择是标准库 json，但 simplejson 作为它的上游，在功能和性能上都值得多看一眼。

1、 定位

Python 自带的 json 模块够用，但更新节奏慢。simplejson 作为上游，新特性和优化会先在这里落地。开发者可以用它直接替代标准库，改动只有一行 import。

纯 Python 实现，没有任何外部依赖。安装后直接使用，性能敏感的场景下可以通过 C 扩展获得加速。代码量不大，遇到边界情况可以直接读源码排查。

对于团队项目来说，零依赖意味着少一个需要维护的底层库。在容器镜像中也能减少一层潜在的兼容问题。

simplejson 长期被 CPython 核心团队维护，代码质量和性能优化有持续保障。作为 json 标准库的上游，它的每次更新都会经过大量验证。

2、 编码

编码器通过 default 参数支持扩展。任何对象都可以定制序列化方式，不需要修改类本身。标准库无法直接处理 datetime、Decimal 等类型，simplejson 通过自定义 encoder 可以覆盖这些场景。

RawJSON 类型允许将预编码的 JSON 字符串直接嵌入输出。某些场景下数据已经完成序列化，重复编码不仅多余，还会带来性能损耗。RawJSON 跳过二次编码，保持输出效率。使用时需要注意：它绕过了正常的序列化和校验流程，只应在嵌入内容完全可信时启用。

3、 解码

解码器支持 UTF-8 以外的编码格式。object_hook 和 object_pairs_hook 参数可以对解码结果做后处理。

实现 JSON-RPC 这类需要更丰富类型系统的协议时，这个能力是关键。解码后的 JSON 对象可以自动转换成目标类型，省去一层转换代码。对于深层嵌套的 JSON 结构，object_pairs_hook 保留了键值对的原始顺序，这在某些协议实现中是硬性要求。

解码器的容错能力也比标准库更强。面对格式不规范的输入，simplejson 提供了多种控制参数，让开发者根据场景选择严格模式或宽松模式。

4、 兼容性

测试已覆盖 Python 3.14 的 free-threaded 构建，同时保持对 Python 3.8+ 的完整兼容。旧版 Python 2.7 的 wheel 仍在发布。

一个库能同时支持从 2.7 到 3.14 的跨度，在 Python 生态里相当少见。对于维护着遗留系统、又在逐步迁移到 Python 3 的团队，这意味着同一套 JSON 处理代码可以贯穿迁移全程，不需要中途换库。

5、 小结

simplejson 不是新项目，但它稳定、可靠、覆盖广。作为标准库 json 的上游，它提供了更灵活的能力和更广的兼容范围。不需要额外依赖，安装即用，适合对 JSON 处理有更高要求的 Python 项目。

如果你在用 Python 做后端开发、数据管道或 API 接口，simplejson 是一个值得考虑的替换方案。改动成本很低，换来的是更完整的特性和更长的兼容窗口。

plejson 是一个值得考虑的替换方案。改动成本很低，换来的是更完整的特性和更长的兼容窗口。