JSONPath 测试器
JSONPath 表达式
JSON 输入
结果
| 语法 | 说明 |
|---|---|
| $ | 根对象或数组 |
| @ | 当前节点（用于过滤表达式） |
| object.property | 点号表示的子节点 |
| ['object'].['property'] | 方括号表示的子节点或子节点集合 |
| ..property | 递归下降 |
| * | 通配符。选择所有元素 |
| [n] | 从数组中选择第 n 个元素 |
| [n1,n2] | 选择数组中的第 n1 和 n2 项（并集） |
| [start:end:step] | 数组切片运算符 |
| ?(expression) | 过滤表达式 |
| (expression) | 脚本表达式 |
技术详情
JSONPath 测试器的工作原理
工具功能
JSONPath 测试器允许你使用 JSONPath 表达式查询嵌套的 JSON 数据，类似于 XPath 处理 XML 的方式。该 jsonpath 测试器既可作为 JSONPath 表达式测试工具，也可作为 json 选择器，帮助开发者从复杂的 JSON 结构中提取特定的值、数组或对象。当你需要在线测试 jsonpath 时，此工具会显示所有匹配的值及其路径。它支持多种 JSONPath 语法，包括点表示法（ $.store.book）、括号表示法（ $['store']['book']）、通配符（ $..*）、数组切片以及过滤表达式。该工具遵循 jsonpath-plus 语义；JSONPath 的实现存在差异，因此如果你的表达式在其他地方可用但在这里不可用，可能是方言差异导致。它同时展示匹配到的值和 JSONPath 路径，便于理解表达式如何在 JSON 结构中进行导航。
常见开发者使用场景
开发者在处理 API 响应、配置文件或复杂的嵌套 JSON 数据结构时会使用 JSONPath 测试器。JSONPath 表达式测试工具可帮助从深层嵌套对象中提取特定字段、按谓词过滤数组，或查找某个特定键的所有出现位置。许多开发者使用 JSONPath 测试器来查询来自 REST API 的 JSON 数据、解析日志文件，或在复杂的配置对象中导航。该工具在调试数据转换、验证 API 响应或理解复杂的 JSON schema 时非常有价值。在运行 JSONPath 查询之前，你可能希望使用 JSON Formatter 格式化 JSON 以提升可读性。对于配置文件，JSON ↔ YAML Converter 可帮助在格式之间转换。检查数组数据时，JSON Array to Table 工具可将结果导出为表格格式，便于分析。
数据格式、类型或变体
JSONPath 提供多种方式来遍历 JSON 结构。该工具支持根选择器（$）、子选择器（. 或 []）、后代选择器（ ..）、数组索引（[0]、[-1]）以及数组切片（ [0:3]）。开发者常用的 JSONPath 表达式包括：
$.items[*].id— 从 items 数组中提取所有 id 字段$..id— 查找任意嵌套层级中的所有 id 字段$['key-with-dash']— 访问包含特殊字符的键$..book[?(@.price < 10)].title— 按价格过滤书籍并提取标题
这些表达式展示了 JSONPath 如何查询嵌套数组、按谓词过滤对象，以及从复杂结构中提取特定字段。
常见陷阱与边界情况
一个常见错误是将 JSONPath 与 JavaScript 对象属性访问混淆，因为 JSONPath 在数组过滤和通配符方面使用不同的语法。另一个问题是理解何时使用点表示法与括号表示法：点表示法适用于简单键名，但当键包含特殊字符或需要使用表达式时必须使用括号表示法。数组索引也可能比较棘手：像 [-1] 这样的负索引表示最后一个元素，但并非所有 JSONPath 实现都支持。过滤表达式必须使用正确的比较运算符，并用 @ 引用当前项。后代选择器（..）如果匹配到的元素多于预期，可能会返回意外结果。开发者应使用多种 JSON 结构测试 JSONPath 表达式，包括空数组、null 值以及深度嵌套对象等边界情况。某些 JSONPath 实现在处理边界情况时存在细微差异，因此测试至关重要。
错误与校验
在使用 JSONPath 时，可能会出现多种错误情况。无效的 JSON 输入会在评估 JSONPath 表达式之前触发解析错误。无效的 JSONPath 表达式会返回错误信息，指出语法问题所在。当表达式在 JSON 结构中未匹配到任何值时，会以空数组形式返回空结果——这是正常行为，并非错误。该工具会同时校验 JSON 语法和 JSONPath 表达式语法，并为格式不正确的输入提供清晰的错误提示。如果你的 JSONPath 表达式有效但没有返回结果，可能是表达式与 JSON 数据结构不匹配，或数据中不包含预期字段。
何时使用此工具而非代码
使用此 JSONPath 测试器可快速开发查询、调试复杂表达式或探索 JSON 数据结构。它非常适合在将 JSONPath 表达式写入代码之前进行测试，尤其是在处理不熟悉的 API 或复杂嵌套数据时。可视化反馈有助于定位表达式为何匹配或不匹配特定数据。对于生产代码，请使用集成到应用中的 JSONPath 库，以高效处理 JSON 数据。浏览器工具擅长交互式开发与探索，而基于代码的方案则提供性能、类型安全以及与数据处理流水线的集成。对于大型数据集或高性能应用，使用编程语言中的原生 JSONPath 实现通常比基于浏览器的工具性能更好。