JOLT把JSON改造玩成俄罗斯套娃，3层嵌套后开发者集体破防|json|字符串|索引|通配符|键名

37%的API集成故障源于数据格式不匹配，而JOLT（JSON转换语言）被设计来解决这个痛点——却也让无数开发者卡在"通配符地狱"里。这篇指南的目标读者很明确：没碰过JOLT的人，或者用过但搞不懂wildcard为什么抽风的人。

基础操作：shift就像搬家公司的标签系统

JOLT的核心语法是个数组包裹对象，每个对象包含operation和spec。最常用的是shift操作，逻辑直白：左边是原地址，右边是新地址，用点号（.）表示层级。

看个实际场景。输入JSON长这样：

{ "client": { "name": "Sample Client", "email": "sample-client@email.com", "ssn": "123.456.789.10", "birthDate": "02/15/1985", "address": "Sample Client street, 123", "country": "United States", "number": "8888-8888" } }

目标是把client重命名为customer，name改成fullName，number同时复制到phoneNumber和mobileNumber。JOLT spec这么写：

[ { "operation": "shift", "spec": { "client": { "name": "customer.fullName", "birthDate": "customer.birthDate", "address": "customer.address.street", "country": "customer.address.country", "number": ["customer.phoneNumber", "customer.mobileNumber"] } } } ]

方括号语法["a", "b"]是复制操作的关键——一个值拆成两份，分别塞进不同位置。这比普通字段映射多一层抽象，也是新手第一个踩坑点：以为JOLT是"查找替换"，其实是"导航+重组"。

通配符：*和&的配对游戏

真实世界的JSON很少像示例那么规整。数组里有20个对象，键名动态生成，这时候*（星号通配符）和&（引用符）登场。

*匹配任意键名或数组索引。&把匹配到的内容"记住"，在输出路径里复用。两者配合，能把动态结构拍扁成规整格式。

假设输入是订单列表，每个订单有动态ID作为键：

{ "orders": { "ORD-001": { "total": 150, "status": "shipped" }, "ORD-002": { "total": 89, "status": "pending" } } }

目标转成数组，保留订单ID作为字段。spec：

{ "operation": "shift", "spec": { "orders": { "*": { "total": "orderList[&1].amount", "status": "orderList[&1].state", "$": "orderList[&1].orderId" } } } }

&1的含义：向上回溯1层，取那层的匹配值。这里*匹配到ORD-001和ORD-002，&1就把这两个字符串分别填入数组索引位置。$是特殊符号，代表当前层的键名本身——所以ORD-001变成了orderId字段的值。

数字后缀的层级计算容易晕。规则是：&0是当前层，&1是父层，&2是祖父层。嵌套超过三层时，建议画个树状图，否则&3和&4的指向会把自己绕进去。

嵌套结构的递归陷阱

JOLT没有原生递归语法。遇到深度不确定的嵌套——比如文件夹树、评论嵌套回复——需要手动展开层级，或者用shift的多次串联。

一个常见模式是"拍平"嵌套对象。输入：

{ "user": { "profile": { "settings": { "notifications": { "email": true, "sms": false } } } } }

想要user_profile_settings_notifications_email这种扁平键名。spec用多级*穿透：

{ "operation": "shift", "spec": { "user": { "profile": { "settings": { "notifications": { "*": "user_profile_settings_notifications_&" } } } } } }

这里&不带数字后缀，默认取当前层匹配值。输出键名是硬编码前缀+动态后缀的拼接，适合配置类数据的快速索引。