JavaScript解析嵌套JSON后,如何转成扁平字段并保留数组结构?
解析嵌套 JSON 时,可以先用 JSON.parse() 得到 JavaScript 数据,再递归展开普通对象的层级,把路径合并成字段名;遇到数组则保留数组,不把元素改成带下标的字段。这样,user.profile.name 会成为一个扁平字段,而 orders 仍是数组,数组内对象的字段也会在各自元素中展开。
下面实现会保留数组的长度、顺序和嵌套层级,也会保留 null、空数组和空对象。路径使用点号连接;如果原始字段名含有点号或反斜杠,会先转义,避免不同路径合并成同一个字段名。
先确定扁平化后的数据结构
扁平化时,“数组仍然是数组”和“数组元素也变成扁平字段”可以同时做到。例如,输入中的 orders 是一个数组,输出仍然是 orders 数组,但其中每个对象的 product.name 会在该元素内部展开。
| 输入结构 | 输出结构 | 处理方式 |
|---|---|---|
user.profile.name | user.profile.name 字段 | 普通对象逐层展开 |
tags: ["js", "json"] | tags: ["js", "json"] | 保留原数组 |
orders: [{product: {name: "键盘"}}] | orders: [{ "product.name": "键盘" }] | 保留数组,对数组中的对象分别展开 |
empty: {} | empty: {} | 保留空对象,避免数据丢失 |
value: null | value: null | 保留 null |
这里的路径键只是普通字符串,并不是 JavaScript 对象的层级访问语法。比如,结果中的 "user.profile.name" 是一个键名;读取时应使用 result["user.profile.name"],而不是 result.user.profile.name。
编写解析与扁平化函数
以下代码不依赖第三方库,可在浏览器或 Node.js 中使用。它把普通对象展开成扁平字段;数组本身保持数组结构,并递归处理数组里的对象和子数组。
function isJsonObject(value) {
return value !== null &&
typeof value === "object" &&
!Array.isArray(value);
}
function escapePathSegment(segment) {
return String(segment)
.replace(/\\/g, "\\\\")
.replace(/\./g, "\\.");
}
function definePath(target, segments, value) {
const key = segments.map(escapePathSegment).join(".");
// 使用 defineProperty,避免 "__proto__" 等字段名被当作特殊属性处理。
Object.defineProperty(target, key, {
value,
enumerable: true,
writable: true,
configurable: true
});
}
function flattenObjectInto(target, source, prefix = []) {
for (const key of Object.keys(source)) {
const segments = prefix.concat(key);
const value = source[key];
if (isJsonObject(value) && Object.keys(value).length > 0) {
// 非空对象继续展开到同一个结果对象中。
flattenObjectInto(target, value, segments);
} else {
// 数组、空对象、null 和基本类型作为字段值保留。
definePath(target, segments, transformValue(value));
}
}
}
function flattenObject(source) {
const result = {};
flattenObjectInto(result, source);
return result;
}
function transformValue(value) {
if (Array.isArray(value)) {
// 不把数组转成带下标的键;递归处理数组内的值。
return value.map(transformValue);
}
if (isJsonObject(value)) {
// 对数组元素中的对象,同样展开其内部对象层级。
return flattenObject(value);
}
return value;
}
function parseAndFlatten(jsonText) {
if (typeof jsonText !== "string") {
throw new TypeError("jsonText 必须是 JSON 字符串");
}
const parsed = JSON.parse(jsonText);
return transformValue(parsed);
}
JSON.parse() 负责把文本转换为 JavaScript 值,transformValue() 再按值的类型处理数据:对象交给扁平化函数,数组通过 map() 保持数组形态,其他值则原样返回。若输入顶层本身是数组,结果也会是数组;若输入是数字、字符串、布尔值或 null,函数会返回相应的解析结果。

用一组数据查看输出
把 JSON 文本传给 parseAndFlatten(),即可获得转换后的对象:
const input = `{
"user": {
"id": 42,
"profile": {
"name": "林",
"active": true
}
},
"tags": ["js", "json"],
"orders": [
{
"id": "A-100",
"product": {
"name": "键盘"
},
"attributes": [
{
"key": "颜色",
"value": "黑色"
}
]
},
null,
{
"id": "A-101"
}
],
"matrix": [[1, 2], [3, 4]],
"empty": {},
"nullable": null
}`;
const result = parseAndFlatten(input);
console.log(JSON.stringify(result, null, 2));
输出如下:
{
"user.id": 42,
"user.profile.name": "林",
"user.profile.active": true,
"tags": [
"js",
"json"
],
"orders": [
{
"id": "A-100",
"product.name": "键盘",
"attributes": [
{
"key": "颜色",
"value": "黑色"
}
]
},
null,
{
"id": "A-101"
}
],
"matrix": [
[
1,
2
],
[
3,
4
]
],
"empty": {},
"nullable": null
}
可以看到,user 下的普通对象层级被展开成带点号的字段;tags 和 matrix 仍然是数组,顺序和嵌套关系未改变。orders 也仍然是数组,第一项里的 product 对象被展开为 "product.name",attributes 则继续保留为数组。数组中的 null 和没有额外嵌套字段的订单对象也都被保留。
读取字段并检查结果
扁平字段包含点号时,应使用方括号和完整键名访问:
console.log(result["user.profile.name"]); // 林
console.log(result["user.id"]); // 42
console.log(Array.isArray(result.tags)); // true
console.log(result.orders.length); // 3
console.log(result.orders[0]["product.name"]); // 键盘
可以在开发阶段加上简单断言,确认转换结果满足预期:
console.assert(result["user.profile.name"] === "林");
console.assert(Array.isArray(result.tags));
console.assert(Array.isArray(result.orders));
console.assert(result.orders[1] === null);
console.assert(result.orders[0]["product.name"] === "键盘");
断言失败时,通常可以先分别检查原始 JSON 是否有效、目标字段路径是否正确,以及该字段是否位于数组元素中。数组元素内部的扁平字段要先取出对应元素,再按完整键名读取,例如 result.orders[0]["product.name"]。
字段名中含有点号时的处理
如果原始数据中有一个字段名本身包含点号,直接用点号拼接路径可能产生歧义。例如:
{
"settings": {
"ui.theme": "dark"
}
}
代码会把字段名里的点号转义。扁平结果中的实际键名是 settings.ui\.theme;如果通过 JSON.stringify() 输出,反斜杠还会按 JSON 规则转义显示。反斜杠本身也会先转义,因此字段名里的点号和路径分隔用的点号可以区分。
这类键名适合用作扁平数据传输或展示字段,但如果后续系统要把它重新还原成原始嵌套 JSON,就需要使用同一套路径转义规则解析键名。还原时不要简单地按 . 拆分,否则包含点号的原始字段名会被拆错。
什么时候要把数组元素也展开成带下标的字段
本文代码把数组保留为真正的数组,因此 orders[0].id 不会成为结果对象的键;对应数据位于 result.orders[0].id。另一种常见约定是将数组元素也转成路径,例如 "orders[0].id"。这种格式更接近“所有值都变成路径键”的扁平映射,但数组不再以数组的形式存在,消费端也要按约定解析下标才能还原结构。
两种格式服务于不同的数据契约:
- 下游需要遍历数组、按顺序渲染列表或保留数组嵌套时,保留数组结构更合适。
- 下游接口只接收路径键值对,且约定了数组下标格式时,才考虑把下标写入字段名。
- 同一个接口应固定一种格式。不要在不同字段上临时决定是否保留数组,否则调用方难以判断字段类型。
如果目标是把数据展示在表格中,可以在展示层单独遍历数组;不必为了表格展示而提前破坏数据结构。
JSON 解析失败与使用边界
JSON.parse() 只接受符合 JSON 语法的文本。解析失败时会抛出 SyntaxError,可以在调用处捕获并反馈输入无效:
try {
const result = parseAndFlatten(input);
console.log(result);
} catch (error) {
if (error instanceof SyntaxError) {
console.error("JSON 格式不正确,请检查引号、逗号和括号。");
} else {
throw error;
}
}
JSON 字符串中的属性名和字符串值必须使用双引号;尾随逗号、注释和未加引号的键名都不是标准 JSON。若数据来源可能返回空字符串或其他非 JSON 内容,应在调用解析函数前按业务规则处理,不要把解析失败的内容当成空对象悄悄继续。
这段实现适用于从 JSON 文本得到的数据。如果输入已经是 JavaScript 对象,不要再传给 JSON.parse();可以直接调用 transformValue()。另外,扁平化会改变普通对象的访问方式,但不会验证业务字段是否齐全,也不会替代数据格式校验。若结果要写入页面,仍应按页面框架的安全方式渲染文本,避免把外部数据直接当作 HTML 插入。
使用这套实现时,先确认下游希望得到的是路径键映射还是保留数组的对象;确定结构后,再用包含普通嵌套对象、数组、空对象和 null 的样例检查结果。这样既能压平需要快速访问的字段,也能保留数组顺序和层级,减少后续调用方对数据结构的误解。
在处理嵌套 JSON 的接口服务和业务后台中,解析与字段转换也常伴随数据库读写、并发请求及数据存储。A5idc数据提供香港、美国、日本等多地区物理服务器,涵盖 Xeon 与 AMD EPYC 平台,并有搭配较大内存和 NVMe 存储的配置,可为接口程序、数据库及多任务后台提供计算与存储资源;不同地区的线路方案也可承载面向相应访问区域的业务部署。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9788.html



