json-key-parser vs jsonpath-ng：简洁在凌乱的 JSON 中获胜，强大功能适用于复杂查询

Source: Dev.to

Source: …

哲学与 API

json-key-parser 示例（单行代码）：

from json_parser import JsonParser

result = JsonParser(data, ["first_name", "street", "address*"]).get_data()

它会递归遍历所有层级，处理列表，并自动将重复键合并为列表。

jsonpath-ng 等价写法（多条表达式）：

from jsonpath_ng import parse

first_names = parse('$..first_name').find(data)
streets = parse('$..street').find(data)
addresses = parse('$..address*').find(data)  # * 可用，但并不完全相同

随后需要从 Match 对象中提取 .value 并自行处理合并。

快速脏数据提取的胜者： json-key-parser。

Power & Features

json-key-parser 在以下情况下表现出色：

• JSON 结构不可预测或经常变化（第三方 API、日志、抓取的数据）
• 只想得到一个包含所需字段的扁平 dict/list
• 不同嵌套层级出现重复键（它会智能合并）
• 想避免使用防御式的 data.get("a", {}).get("b", []) 链式调用

jsonpath-ng 在以下情况下更为强大：

• 需要过滤器，例如 $.books[?(@.price > 20)]
• 想要 就地更新 或 删除 值（expr.update(data, new_value)）
• 需要算术、正则、切片或父节点引用
• 正在进行元编程（它提供了干净的 AST）
• 想要完整路径返回（match.full_path）
• 需要诸如 len()、keys()、排序等扩展功能

依赖与体积

• json-key-parser: 纯标准库，安装后小于 50 KB，无外部依赖。
• jsonpath-ng: 最近的版本同样没有外部依赖（没有运行时 ply），仍然很小。

两者均可通过单个 pip 命令安装，支持 Python 3.8+。

性能与成熟度

• jsonpath-ng 已成熟，经过大量测试，并在大规模生产环境中使用。
• json-key-parser 则是全新（Beta）但专注度极高；其递归在大多数使用场景下极为快速。

对于拥有成千上万个嵌套对象的大型 JSON 文档，编译后的 jsonpath‑ng 表达式在复杂查询上可能略胜一筹。对于简单的键提取，json-key-parser 通常更快，因为它避免了解析查询语言。

何时选择哪种方式

如果你使用 json-key-parser，请满足以下情况：

• 编写 ETL 脚本、API 客户端或数据清洗笔记本
• JSON 结构混乱，只需要“first_name、email、total”等字段，而不在乎嵌套层级
• 重视可读性和最少的代码量

如果你使用 jsonpath-ng，请满足以下情况：

• 需要条件过滤或数据转换
• 构建需要精确、可重复查询的库或工具
• 想要就地修改 JSON 结构

Pro tip: 你甚至可以在同一个项目中同时使用两者——先用 jsonpath‑ng 解析复杂部分，然后将结果交给 json-key-parser 进行最终的扁平化。

要点

如果 jsonpath‑ng 是 JSON 查询的瑞士军刀，那么 json-key-parser 则是针对最常见痛点——“我只需要这些该死的键”——的精准手术刀。

在约 80 % 处理 API 和配置的真实 Python 脚本中，json-key-parser 能为你节省的时间和烦恼，超过今年发布的任何其他库。

Install json-key-parser

pip install json-key-parser

使用相同的数据尝试这两个库，看看哪个能更快地减少你的样板代码。

你现在遇到的最大的 JSON 解析难题是什么？在评论中告诉我——我会展示哪个工具能更快解决它。