jsongrep查询语法完整清单：10个正则路径运算符让你精通JSON搜索

【免费下载链接】jsongrepA path query language for JSON, YAML, TOML, and other serialization formats.项目地址https://gitcode.com/gh_mirrors/js/jsongrep点击查看免费下载jsongrep 是一个用 Rust 编写的命令行工具和库专门用于在 JSON、YAML、TOML 等文档中快速执行路径查询path query。它的查询语言复用了正则表达式的设计思路——把 JSON 文档看作一棵树用路径上的正则描述你想匹配的位置。只需掌握下面 10 个核心运算符你就能写出不限深度的复杂 JSON 搜索。为什么 jsongrep 的查询像正则表达式JSON 文档本质上是一棵树对象和数组层层嵌套边由字段名或数组下标标记。jsongrep 让你用正则式运算符描述路径集合而不是像jq那样描述如何转换数据**.name # 在任意深度的嵌套对象中找 name users[*].email # 匹配 users 数组里每个元素的 email (error|warn).* # error 或 warn 下的任意一层字段查询会先编译为 NFA非确定有限自动机再确定化为 DFA确定有限自动机执行因此搜索速度非常快。相关实现可以看 src/query/nfa.rs、src/query/dfa.rs 和 src/query/parser.rs。10 个正则路径运算符完整清单#运算符示例含义1顺序拼接foo.bar.baz依次经过foo→bar→baz2字段访问foo/foo bar匹配指定字段含空格需加引号3数组下标[0]、[1]匹配数组中的特定位置4数组切片[1:3]、[3:]、[:2]匹配一段下标结束位置不包含5数组通配符[*]匹配数组的所有元素6字段通配符*匹配任意一层字段名7选择并集year \| category匹配多个字段之一8可选foo?.barfoo可有可无9重复Kleene 星foo*前一步重复零次或多次10递归下降**匹配零层或多层任意字段所有运算符都可以通过括号任意嵌套分组比如foo.(bar|baz).qux匹配foo.bar.qux或foo.baz.qux。完整文法定义见 src/query/grammar/query.pest。1. 顺序拼接按路径逐层深入最基础的写法字段之间用.连接jg name.first person.json # 输出 name.first: John2. 字段访问支持带空格的字段名普通字段直接写名称字段名含空格等保留字符时用双引号包裹jg first name.value data.json3. 数组下标精确定位下标从 0 开始字段后可连续追加多个下标如items[0][1]jg hobbies[1] person.json # hobbies.[1]: # yoga4. 数组切片只取一段数据写法与 Python 切片一致结束下标不包含[1:3]第 2 到第 4 个元素[3:]从第 4 个开始到末尾[:2]前 2 个元素5. 数组通配符[*]展开所有元素这是最常用的运算符之一取出数组中每个元素echo {users: [{name: Alice}, {name: Bob}]} | jg users[*].name # users.[0].name: # Alice # users.[1].name: # Bob6. 字段通配符*任意一层字段注意*只匹配一层字段不是递归搜索——这是它和**的关键区别jg dependencies.*.version Cargo.toml # 列出所有依赖的版本号7. 选择运算|一次取多个字段用|在一层内做或省掉多次查询jg prizes[0].(year|category) prize.json # prizes.[0].year: # 2025 # prizes.[0].category: # chemistry8. 可选运算?字段可能不存在foo?表示该步可有可无适合处理字段可选的结构如 TOML/YAML 配置jg database.port?.max_connections config.yaml9. 重复运算*某一步重复任意次后缀*让前一个步骤重复零次或多次比如users*会匹配零个、一个或多个users层。10. 递归下降**任意深度搜索**即字段通配符 Kleene 星是最强的运算符匹配任意深度的路径jg **.name tree.json如果想要在对象和数组中都递归使用(* | [*])*jg (* | [*])*.foo data.json # 在任何深度找到所有名为 foo 的字段 提示不想手写**CLI 的-F/--fixed-string参数会自动把查询当作字段名做任意深度搜索例如jg -F firstname prize.json等价于**firstname的语义。实战组合写出复杂查询的三个技巧括号改变优先级(error|warn).message先分组再拼接不加括号会被解析错。多文件批量查询同一个查询只编译一次可依次作用于多个文件并自动识别格式JSON/YAML/TOML/JSONL/CBOR/MessagePackjg services.*.image staging/docker-compose.yml prod/docker-compose.yml配合输出参数-r输出原始字符串类似jq -r、--count统计匹配数、-l只打印有匹配的文件名方便管道处理。完整测试数据可参考 tests/data/simple/simple.json。性能如何基准测试一图看懂jsongrep 使用 Criterion 与 jsonpath-rust、jmespath、jaq、jql 四个主流查询库做了对比基准测试数据从几 KB 的小样例到 190 MB 的 GeoJSON 文件。下图是 xlarge 规模的端到端解析 编译 搜索耗时小提琴图jsongrep 各查询类型的分布明显更窄更靠左意味着更快也更稳定基准方法论与源码见 benches/README.md 和 benches/query.rs。快速上手与延伸阅读 安装与最小示例cargo install jsongrep # 或 brew install jsongrep echo {a: {b: 1}} | jg a.b想了解更多可以逛这些目录查询引擎核心src/query/AST、解析、NFA/DFA可运行的查询构建器示例examples/query_builder.rs解析 查询完整流程示例examples/parse_and_query.rs贡献指南CONTRIBUTING.md 最后一个小知识文法中还保留了/regex/语法用于按模式匹配字段名但引擎尚未实现执行该语法目前会报 Unsupported feature 错误——规划中敬请期待。赞分享【免费下载链接】jsongrepA path query language for JSON, YAML, TOML, and other serialization formats.项目地址https://gitcode.com/gh_mirrors/js/jsongrep点击查看免费下载相关推荐PyPTO终极指南CANN新范式AI加速器高性能算子开发框架完全解析PyPTO终极指南CANN新范式AI加速器高性能算子开发框架完全解析 PyPTO 是 CANN 推出的面向 AI 加速器的高性能算子开发框架采用 PTOP编译器人工智能高性能计算CANNAscendHound正则表达式搜索5个高级查询语法完全指南Hound正则表达式搜索5个高级查询语法完全指南 Hound是一款闪电般快速的代码搜索引擎专门为开发者提供高效的正则表达式搜索功能。这款开源工具基于Go语言搜索引擎开发者工具后端前端Lertaro搜索语法大全10个运算符玩转fzf风格模糊搜索Lertaro搜索语法大全10个运算符玩转fzf风格模糊搜索 Lertaro 是一款面向 Windows 的高性能本地文件搜索工具基于 NTFS MFT 即桌面应用搜索引擎开发工具插件系统CLI上一篇React语法高亮神器react-syntax-highlighter一站式解决代码展示难题下一篇终极指南Weasis开源医学影像查看器的完整使用教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考