JSON Path 测试器：使用 JSONPath 表达式查询 JSON 数据

2026年3月31日 · 12 分钟阅读

理解 JSONPath

JSONPath 是专门为 JSON 数据结构设计的查询语言。可以把它看作是一个强大的搜索工具，让你能够精确地浏览复杂的 JSON 文档，类似于 XPath 对 XML 的作用或 SQL 查询对数据库的作用。

使用 JSONPath，你可以运行详细的查询，在大型数据集中准确找到所需内容，而无需编写复杂的循环或递归函数。例如，如果你正在处理一个包含多层客户、订单和产品数据的大型 JSON 文件，JSONPath 可以直接提取所有下单金额超过 100 美元的客户姓名，而无需手动遍历每一层。

当处理嵌套的 JSON 结构或返回复杂 JSON 响应的 API 时，JSONPath 的真正威力就显现出来了。它极大地简化了数据处理，让你可以用单个表达式直接获取所需信息。在购物应用程序中，你可能需要快速查找特定类别下列出的所有商品以更新价格或检查库存水平。JSONPath 可以帮助你立即定位这些数据。

为什么 JSONPath 对开发者很重要

现代应用程序经常以 JSON 格式交换数据。无论你是使用 REST API、处理配置文件还是处理数据库响应，JSON 无处不在。JSONPath 提供了几个关键优势：

• 降低代码复杂性：用单个表达式替换数十行嵌套循环
• 提高可读性：JSONPath 表达式具有自文档化特性，比过程式代码更容易理解
• 更好的可维护性：数据结构的更改只需对 JSONPath 查询进行最少的更新
• 跨语言支持：JavaScript、Python、Java、PHP 和大多数其他语言都有 JSONPath 实现
• 更快的开发速度：无需编写完整应用程序即可立即测试和验证查询

开始使用 JSON Path 测试器

JSON Path 测试器是一个必不可少的工具，可帮助开发者在将 JSONPath 表达式实施到生产代码之前，针对示例 JSON 数据验证这些表达式。这些测试器提供即时反馈，准确显示你的表达式将提取哪些数据。

使用 JSON Path 测试器非常简单。你通常将 JSON 数据粘贴到一个面板中，在另一个面板中输入 JSONPath 表达式，然后立即看到结果。这种交互式方法节省了无数小时的调试时间，让你可以尝试不同的查询模式。

优秀 JSON Path 测试器的关键特性

选择 JSON Path 测试器时，请寻找以下基本功能：

• 实时验证：在你输入表达式时提供即时反馈
• 语法高亮：为 JSON 和 JSONPath 提供颜色编码以提高可读性
• 错误消息：当表达式失败时提供清晰的解释
• 多种输出格式：以 JSON、数组或格式化文本查看结果
• 示例数据：预加载的示例帮助你学习
• 表达式历史：保存和重用常用查询

JSONPath 语法和运算符

JSONPath 使用特定的语法来浏览 JSON 结构。理解这些运算符对于编写有效的查询至关重要。该语法设计得很直观，借鉴了 JavaScript 对象表示法和 XPath 的概念。

基本运算符

过滤表达式

过滤表达式是 JSONPath 最强大的功能之一。它们让你可以根据条件选择元素，类似于 SQL 中的 WHERE 子句。过滤器使用 @ 符号来引用正在评估的当前元素。

过滤器中常见的比较运算符包括：

• == - 等于
• != - 不等于
• < - 小于
• <= - 小于或等于
• > - 大于
• >= - 大于或等于
• =~ - 匹配正则表达式

常用 JSONPath 表达式

让我们通过实际示例探索最常用的 JSONPath 表达式。这些模式涵盖了处理 JSON 数据时会遇到的大多数实际场景。

选择根元素和子元素

最简单的 JSONPath 表达式直接导航到特定属性：

// 选择根元素
$

// 选择直接子属性
$.store

// 选择嵌套属性
$.store.book

// 使用括号表示法选择（对于包含空格或特殊字符的属性很有用）
$['store']['book']

处理数组

数组在 JSON 中很常见，JSONPath 提供了多种访问其元素的方法：

// 第一个元素
$.store.book[0]

// 最后一个元素
$.store.book[-1]

// 多个特定元素
$.store.book[0,2,4]

// 元素范围（切片）
$.store.book[0:3]  // 元素 0、1、2

// 从索引 2 开始的所有元素
$.store.book[2:]

// 索引 3 之前的所有元素
$.store.book[:3]

// 每隔一个元素
$.store.book[::2]

使用通配符

通配符帮助你选择多个元素而无需知道它们的确切名称：

// store 的所有直接子元素
$.store.*

// 所有书籍（无论数组位置如何）
$.store.book[*]

// 所有书籍的所有属性
$.store.book[*].*

递归下降

递归下降运算符（..）搜索 JSON 结构的所有层级：

// 查找文档中任何位置的所有 'price' 属性
$..price

// 查找所有 'author' 属性
$..author

// 查找任何数组中的所有元素
$..[*]

测试 JSONPath 表达式

在部署之前彻底测试 JSONPath 表达式可以防止运行时错误并确保提取正确的数据。系统的测试方法可以节省调试时间并提高代码可靠性。

逐步测试过程

1. 验证你的 JSON：使用 JSON 验证器确保数据结构正确
2. 从简单开始：从基本表达式开始，逐步增加复杂性
3. 测试边界情况：验证空数组、null 值和缺失属性的行为
4. 检查数组边界：确保基于索引的查询不会超出数组长度
5. 验证过滤逻辑：使用各种数据值测试过滤器以确认它们按预期工作
6. 比较结果：将输出与手动提取的数据进行交叉检查

常见测试场景

测试 JSONPath 表达式时，请考虑以下场景：

• 空结果：当没有元素匹配你的查询时会发生什么？
• 单个与多个匹配：你的代码是否正确处理这两种情况？
• 类型不匹配：如果你期望的数字属性实际上是字符串怎么办？
• 缺失属性：当可选字段不存在时，你的表达式如何表现？
• 深度嵌套数据：你的查询在所有嵌套级别都有效吗？

使用 JSON Path 测试器的实际示例

让我们使用示例 JSON 数据集来演示实际示例。这些示例展示了 JSONPath 如何解决常见的数据提取挑战。

示例 1：电子商务产品目录

考虑这个表示在线商店的 JSON 结构：

{
  "store": {
    "books": [
      {
        "category": "fiction",
        "author": "Herman Melville",
        "title": "Moby Dick",
        "isbn": "0-553-21311-3",
        "price": 8.99,
        "inStock": true
      },
      {
        "category": "fiction",
        "author": "J.R.R. Tolkien",
        "title": "The Lord of the Rings",
        "isbn": "0-395-19395-8",
        "price": 22.99,
        "inStock": false
      },
      {
        "category": "reference",
        "author": "Nigel Rees",
        "title": "Sayings of the Century",
        "isbn": "0-486-27557-4",
        "price": 8.95,
        "inStock": true
      }
    ],
    "bicycle": {
      "color": "red",
      "price": 19.95,
      "inStock": true
    }
  }
}

以下是针对此数据的有用查询：

示例 2：API 响应处理

在处理 API 响应时，你经常需要从嵌套结构中提取特定字段。考虑这个用户数据响应：

{
  "users": [
    {
      "id": 1,
      "name": "John Doe",
      "email": "[email protected]",
      "address": {
        "street": "123 Main St",
        "city": "Boston",
        "state": "MA",
        "zip": "02101"
      },
      "orders": [
        {"id": 101, "total": 45.99, "status": "shipped"},
        {"id": 102, "total": 23.50, "status": "pending"}
      ]
    },
    {
      "id": 2,
      "name": "Jane Smith",
      "email": "[email protected]",
      "address": {
        "street": "456 Oak Ave",
        "city": "Seattle",
        "state": "WA",
        "zip": "98101"
      },
      "orders": [
        {"id": 103, "total": 89.99, "status": "delivered"}
      ]
    }
  ]
}

针对此 API 响应的有用查询：

// 所有用户电子邮件
$.users[*].email

// 所有城市
$.users[*].address.city

// 所有用户的所有订单 ID
$..orders[*].id

// 状态为 'pending' 的订单
$..orders[?(@.status == 'pending')]

// 来自马萨诸塞州的用户
$.users[?(@.address.state == 'MA')]

// 所有订单的总价值
$..orders[*].total