JSONPath 测试器
实时测试 JSONPath 表达式,查看匹配结果并高亮显示。支持过滤器、通配符和递归下降。免费,基于浏览器。
- 在浏览器中处理
- 工具不会把输入上传到 ZeroTool 服务器
- 免费 · 无需注册
用微信扫描以下二维码即可分享
示例、说明与常见问题 带实际输出的示例、与同类工具的差别,以及常见问题。
JSONPath 语法参考(RFC 9535)
$— 文档根节点.key、['key']、["key"]— 对象成员[n]、[-1]— 数组元素;负索引从末尾倒数[start:end:step]— 切片,例如[0:2]、[1:]、[::-1][0,2]、['title','price']— 一个方括号里放多个选择器,结果按选择器顺序排列[*]、.*— 全部数组元素或对象成员值..key、..[0]、..*— 任意深度的后代[?@.price < 10]— 过滤器;也可写成[?(@.price < 10)][?@.isbn]、[?!@.isbn]— 成员存在 / 不存在[?@.a.b == 'x' && @.c > $.min]— 过滤器内的嵌套路径、&&||!、以 $ 开头的绝对路径length()、count()、match()、search()、value()— RFC 9535 定义的 5 个函数
示例:中文键名的订单数据
键名可以直接用中文,点号写法 $.订单 与方括号写法 $['订单'] 都能用(RFC 9535 允许 ASCII 以外的字符出现在点号后的名称里)。下面是一份虚构的订单数据,第 3 条的金额被后端写成了字符串:
{"订单": [
{"编号": "A1001", "商品": "机械键盘", "金额": 399, "状态": "已发货"},
{"编号": "A1002", "商品": "USB-C 数据线", "金额": 29.9, "状态": "待付款"},
{"编号": "A1003", "商品": "显示器支架", "金额": "159.00", "状态": "已发货"}
]}
$.订单[?@.状态 == '已发货'].编号 得到 ["A1001","A1003"]。
再用 $.订单[?@.金额 > 100].商品 找金额超过 100 的商品,结果只有 ["机械键盘"],显示器支架没有出现:它的金额是字符串 "159.00",RFC 9535 §2.3.5.2.2 规定只有两边同为数字或同为字符串时 < 、> 才可能为真,工具不会提示。看到这种「少了一条」的结果,先检查字段类型。
中文输入法打出的符号
在中文标点状态下输入表达式时,[ 可能变成 【,$ 可能变成 ¥。这两类字符混进表达式后,读法不同:
- 开头写成
¥.订单时,状态行显示语法错误或不支持的语法: 查询必须以 $ 开头(第 1 个字符) · 表达式含全角字符(¥),请改用半角(ASCII)输入。。
- 紧跟在名称后面时不会报错。
$.订单【0】.商品会被读成名为「订单【0】」的成员,结果是未找到匹配项,状态行提示表达式含全角字符(【 】)。JSONPath 把它们读作成员名的一部分,不当作 . [ ] * 或 $;请改用半角(ASCII)输入。改成半角的$.订单[0].商品即可。
对象成员的顺序
$.地区.* 这类通配查询按 JavaScript 保存对象成员的顺序返回:形如数组下标的名称(如 "110000")排在前面并按数值升序,其余名称按 JSON 里的顺序排在后面。以地区代码为键的数据会被重新排序:
{"地区": {"440000": "广东省", "110000": "北京市", "310000": "上海市"}}
结果是 ["北京市","上海市","广东省"],不是 JSON 里的顺序。RFC 9535 没有规定对象成员的顺序,其他实现可能给出不同的顺序;需要固定顺序时请把数据改成数组。
限制
- 语法错误和 RFC 9535 之外的语法会显示「语法错误或不支持的语法」和字符位置。RFC 9535 之外的语法包括脚本表达式
[(...)]、=~、in/nin,以及其他库用~取成员名之类的扩展。 $.store.book.length选取名为length的成员,数组没有这个成员,所以结果为空。要按长度筛选,请在过滤器中用length(),例如$[?length(@.book) > 3]。- 结果只列出匹配的值,不显示规范化路径(如
$['store']['book'][0])。 - 同一对象里出现两个同名键时,
JSON.parse只保留后一个值,查询看不到前一个。 - 名称按码点逐个比较,不做 Unicode 规范化(名称选择器见 RFC 9535 §2.3.1.2;过滤器里的字符串比较,工具也按同样方式处理)。
match()与search()把.换成[^\n\r]后,按带u标志的 JavaScript 正则执行(RFC 9485 §5.3)。JavaScript 不接受的模式结果为 false;\d、先行断言等只有 JavaScript 支持的写法也会被接受。- 数字经
JSON.parse转成 JavaScript 数字。超过 253 的整数、位数过多的小数、-0以及超出双精度范围的数会在比较和显示前改变,状态行会列出这些数字,例如9007199254740993 → 9007199254740992。按 RFC 8259 §6,只有 −(253)+1 到 253−1 之间的整数能在各实现间通用,雪花 ID 这类长整数请以字符串传递。 - JSON 格式错误时显示的是浏览器 JavaScript 解析器的原始信息,措辞因浏览器而异。
与其他 JSONPath 方言的区别
kubectl 的 -o jsonpath 模板把表达式写在大括号里,开头的 $ 可以省略;粘贴到这里时只取大括号里的部分,并在前面补上 $。
Java 的 Jayway JsonPath 接受脚本表达式、=~ 和路径末尾的 .length(),本工具按 RFC 9535 解析,会报错并指出位置。
只想筛选数据时用本工具即可;要改写 JSON 的结构,请用 jq Playground。
FAQ
什么是 JSONPath?
JSONPath 是 JSON 的查询语言,类似于 XML 的 XPath。它使用路径表达式从 JSON 文档中选取节点,RFC 9535(2024 年)对它做了标准化。kubectl 的输出模板、AWS Step Functions 和不少 API 测试工具都使用它的变体。
JSONPath 表达式中的 $ 是什么意思?
$ 指 JSON 文档的根元素。所有有效的 JSONPath 表达式必须以 $ 开头。单独使用时,$ 选取整个文档;之后可以链式添加选择器,例如 $.store.book[0].title。[*] 选取数组的全部元素,所以 $.store.book[*].author 返回所有作者。
过滤表达式如何使用?
过滤器写作 [?表达式],@ 表示正在判断的元素。按 RFC 9535,括号可写可不写,$.store.book[?@.price < 10] 与 $.store.book[?(@.price < 10)] 等价。可用 ==、!=、<、<=、>、>= 比较,用 &&、||、! 组合条件,判断 @.author.name 这样的嵌套路径,用 $ 与文档其他位置比较,并可调用 length()、count()、match()、search()、value()。字符串与数字永远不相等:写成 "9.99" 的价格不会小于 10。
递归下降(..)是什么?
.. 运算符递归搜索当前节点的所有后代。例如,$..author 在整个 JSON 树中查找所有 author 字段,无论嵌套深度如何。
为什么显示「语法错误或不支持的语法」?
表达式有语法错误(如字符串或方括号没有闭合),或用了 RFC 9535 没有定义的语法,工具会停下并给出原因和字符位置,不会返回空结果。RFC 9535 之外的写法常见的有脚本表达式 [(@.length-1)](改用 [-1])、=~ 运算符(改用 match() 或 search())、in / nin。显示「未找到匹配项」则说明表达式合法,只是 JSON 里没有符合的内容;如果表达式里有 . 或 【 这类全角字符或中文标点,状态行会提示,因为 JSONPath 把它们当作名称的一部分。
JSON 会被发送或保存吗?
不会。查询由本页的脚本执行,JSON 和表达式不会发送到服务器,也不会写入浏览器存储。统计只记录工具名和动作:有匹配结果的查询提交、点击示例、复制,不记录 JSON 和表达式。