📄 JSON数据
🔍 JSONPath表达式
$.store.book[*].title
$..author
$.store.book[?(@.price < 10)]
$.store.book[0]
$.store.book[-1:]
$..price
$.store.*
$.store.book[?(@.category=="fiction")]
JSONPath是用于查询JSON数据的表达式语言，以下是核心语法规则：
| 语法 | 说明 | 示例 |
|---|---|---|
| $ | 根节点 | 所有路径都以$开头 |
| @ | 当前节点（在过滤表达式中使用） | [?(@.price < 10)] |
| .name | 点记法访问属性 | $.store.book |
| ['name'] | 括号记法访问属性 | $['store']['book'] |
| ..name | 递归搜索属性 | $..title（查找所有title） |
| * | 通配符，匹配所有属性 | $.store.* |
| [n] | 数组索引（从0开始） | $.store.book[0] |
| [start:end] | 数组切片 | $.store.book[0:2] |
| [?(<expr>)] | 过滤表达式 | [?(@.price > 10)] |
| [n1,n2,...] | 多索引选择 | $.store.book[0,2] |
JSONPath查询测试器是一个纯前端的在线工具，无需安装任何软件即可快速测试和验证JSONPath表达式。以下是详细的使用步骤：
第一步：准备JSON数据。在左侧"JSON数据"区域输入或粘贴需要查询的JSON数据。工具会自动验证JSON格式是否正确。如果JSON格式有误，工具会给出错误提示。你也可以使用"格式化"按钮将杂乱的JSON整理成易读的格式，或使用"压缩"按钮将其压缩成单行格式以节省空间。
第二步：编写JSONPath表达式。在右侧"JSONPath表达式"输入框中输入查询表达式。所有表达式必须以$开头表示根节点。你可以使用点记法（$.store.book）或括号记法（$['store']['book']）访问嵌套属性。如果不确定语法，可以点击下方的示例标签快速填入常用表达式。
第三步：执行查询并查看结果。点击"执行查询"按钮，工具会在底部的"查询结果"区域显示所有匹配项。每个结果都会显示完整的路径和对应的值。如果匹配到多个结果，会以列表形式展示。点击"复制结果"按钮可以将结果以JSON格式复制到剪贴板，方便在其他工具中继续处理。
JSONPath在Web开发和数据处理的各个环节都有广泛应用，以下是几个典型的使用场景：
API响应数据提取：在前后端分离的Web应用中，API通常返回结构复杂的JSON数据。使用JSONPath可以快速提取需要展示的字段，而无需编写大量的遍历代码。例如在React或Vue项目中，可以直接用JSONPath从API响应中提取用户信息列表、订单详情等数据，大幅减少代码量并提升可读性。
自动化测试断言：在接口自动化测试（如Postman、JMeter）中，JSONPath常用于验证API返回数据是否符合预期。例如可以用$.code检查状态码是否等于200，用$.data.total验证分页数据的总条数是否正确。JSONPath表达式可以直接嵌入测试脚本中，实现结构化的数据校验。
日志分析与监控：在ELK（Elasticsearch、Logstash、Kibana）等日志分析系统中，JSONPath被广泛用于从结构化的日志JSON中提取关键字段进行聚合分析。例如从应用日志中提取$.level字段统计ERROR级别日志数量，或提取$.responseTime计算平均响应时间。JSONPath的过滤表达式还能实现条件筛选，如只统计响应时间大于1000ms的请求。
JSONPath标准与实现差异：目前JSONPath有两个主要标准：RFC 9535（2024年发布）和早期的Goessner规范。不同语言对JSONPath的实现存在差异，例如Python的jsonpath-ng、Java的Jayway JSONPath、JavaScript的jsonpath-plus等库在过滤表达式语法上可能略有不同。本工具尽量兼容主流语法，但在处理复杂过滤条件时建议对照目标语言的实现文档。
JSONPath vs JMESPath vs jq：JSONPath不是唯一的选择。JMESPath是另一种查询语言，语法更严谨，被AWS CLI和boto3广泛采用。jq是命令行工具，功能最为强大，支持复杂的管道操作和函数调用。选择哪种工具取决于具体场景：JSONPath适合简单查询和嵌入式使用，JMESPath适合云计算场景，jq适合命令行数据处理和复杂转换。
性能注意事项：对于大型JSON文档（如超过10MB），JSONPath查询可能会消耗较多CPU资源。递归搜索（..）和通配符（*）需要遍历整个对象树，时间复杂度为O(n)。在生产环境中使用JSONPath时，建议先通过路径缩小搜索范围，避免在顶层直接使用递归搜索。对于需要频繁查询的场景，可以考虑将JSON数据扁平化为Map结构以提升查询效率。
JSONPath是一种用于从JSON文档中提取特定数据的查询语言，类似于XPath在XML中的作用。它通过类似路径的表达式定位JSON中的节点，支持通配符、递归搜索、过滤条件等功能，让开发者能够以声明式的方式从复杂JSON结构中精确获取所需数据。
JSONPath支持以下核心语法：$表示根节点，@表示当前节点（在过滤表达式中使用），.name访问属性，['name']访问带特殊字符的属性，..递归搜索，*通配符，[0]数组索引，[0:3]数组切片，[?(<expr>)]过滤表达式等。
JSONPath用于JSON数据，XPath用于XML数据。JSONPath语法更简洁（$.store.book[0].title），而XPath语法更复杂（/store/book[1]/title）。JSONPath不支持XPath的轴（axis）和位置函数，但在处理JSON特有的嵌套对象和数组时更加直观和便捷。
JSONPath可以：从复杂JSON中提取特定字段、过滤数组元素（如查找价格大于10的商品）、获取深层嵌套数据、在API测试中验证响应结构、在日志分析中提取关键信息、在自动化脚本中做数据映射等。几乎所有需要处理JSON数据的场景都能用到JSONPath。
不需要。本工具完全在浏览器端运行，使用纯JavaScript实现JSONPath解析，数据不上传服务器。你可以在本地测试任何JSON数据和JSONPath表达式，所有计算都在本地完成，保护数据隐私。
常见原因包括：路径拼写错误（区分大小写）、数组索引越界、使用了不支持的语法特性、JSON数据格式不正确等。建议先用简单的路径（如$.name）验证基本功能是否正常，再逐步增加复杂度。本工具会在出错时给出详细的错误提示，帮助你定位问题。
本工具纯前端运行，处理能力受限于浏览器内存和CPU性能。通常可以流畅处理几MB的JSON文件，但几十MB以上的大型文件可能导致页面卡顿甚至崩溃。建议将大型JSON拆分成小块处理，或仅在本地测试小规模样本数据。