JavaScript中如何将扁平化路径键转换为嵌套对象

在JavaScript开发中，扁平化路径键转换为嵌套对象是一个常见的数据处理需求，比如处理类似user.address.city这样的路径字符串，最终生成{user: {address: {city: 'xxx'}}}的结构，能够大幅简化后续的数据读取和操作逻辑。

基础场景实现

最基础的场景是路径键都是普通字符串，没有数组下标，也没有特殊字符，我们可以通过拆分路径、逐层创建对象的方式实现转换。核心思路是先按分隔符拆分路径字符串，然后遍历拆分后的路径数组，逐层为对象添加属性，如果某一层不存在就先创建空对象。

// 基础版：处理普通路径，无数组下标
function flatPathToNested(obj, path, value) {
  // 按点号拆分路径
  const keys = path.split('.');
  let current = obj;
  // 遍历到倒数第二个键，负责创建嵌套结构
  for (let i = 0; i < keys.length - 1; i++) {
    const key = keys[i];
    // 如果当前层不存在该属性，创建空对象
    if (!current.hasOwnProperty(key)) {
      current[key] = {};
    }
    // 移动到下一层
    current = current[key];
  }
  // 最后一个键赋值
  current[keys[keys.length - 1]] = value;
  return obj;
}

// 测试示例
const result = {};
flatPathToNested(result, 'user.name.firstName', '张三');
flatPathToNested(result, 'user.name.lastName', '李四');
flatPathToNested(result, 'user.age', 20);
console.log(result);
// 输出：{ user: { name: { firstName: '张三', lastName: '李四' }, age: 20 } }

处理数组路径场景

实际开发中路径可能包含数组下标，比如user.hobbies[0]、user.scores[1]这样的形式，这时候需要先识别路径中的数组标识，区分普通属性和数组元素，再进行对应的结构创建。

// 进阶版：支持数组路径，如user.hobbies[0]
function flatPathToNestedAdv(obj, path, value) {
  // 正则匹配路径中的键和数组下标，比如user.hobbies[0]会拆分为['user', 'hobbies', '0']
  const keys = path.split(/[.[]]/).filter(item => item !== '');
  let current = obj;
  for (let i = 0; i < keys.length - 1; i++) {
    const key = keys[i];
    const nextKey = keys[i + 1];
    // 判断下一层是否是数组下标（纯数字）
    const isNextArrayIndex = /^d+$/.test(nextKey);
    if (!current.hasOwnProperty(key)) {
      // 如果下一层是数组下标，当前层创建数组，否则创建对象
      current[key] = isNextArrayIndex ? [] : {};
    }
    current = current[key];
  }
  // 最后一个键赋值，如果是数字下标就转成数字类型
  const lastKey = keys[keys.length - 1];
  current[/^d+$/.test(lastKey) ? Number(lastKey) : lastKey] = value;
  return obj;
}

// 测试示例
const result2 = {};
flatPathToNestedAdv(result2, 'user.hobbies[0]', '篮球');
flatPathToNestedAdv(result2, 'user.hobbies[1]', '足球');
flatPathToNestedAdv(result2, 'user.scores[0]', 90);
flatPathToNestedAdv(result2, 'user.scores[1]', 85);
console.log(result2);
// 输出：{ user: { hobbies: ['篮球', '足球'], scores: [90, 85] } }

批量转换多个路径

实际使用中我们通常会拿到一个扁平化的键值对对象，需要批量将所有路径键转换为嵌套结构，这时候可以遍历对象的所有属性，调用上面的转换函数即可。

// 批量转换扁平对象为嵌套对象
function batchFlatToNested(flatObj) {
  const result = {};
  for (const path in flatObj) {
    if (flatObj.hasOwnProperty(path)) {
      flatPathToNestedAdv(result, path, flatObj[path]);
    }
  }
  return result;
}

// 测试示例
const flatData = {
  'user.name.firstName': '王五',
  'user.name.lastName': '赵六',
  'user.age': 25,
  'user.hobbies[0]': '跑步',
  'user.hobbies[1]': '游泳',
  'user.scores[0]': 88,
  'user.scores[1]': 92
};
const nestedData = batchFlatToNested(flatData);
console.log(nestedData);
// 输出：{ user: { name: { firstName: '王五', lastName: '赵六' }, age: 25, hobbies: ['跑步', '游泳'], scores: [88, 92] } }

注意事项

在使用上述方法时需要注意几个问题：首先是路径分隔符的兼容性，如果路径中使用的是其他分隔符比如斜杠，只需要修改split的正则即可；其次是避免路径冲突，比如同时设置user.name和user.name.firstName，后设置的会覆盖先设置的嵌套结构，需要根据实际业务场景判断是否需要做冲突处理；最后是特殊字符的处理，如果路径键中包含点号或者方括号，需要对路径做转义处理，避免拆分错误。

掌握扁平化路径键转换为嵌套对象的方法后，我们可以更灵活地处理各类结构化数据，减少手动拼接对象的冗余代码，提升开发效率。

JavaScript扁平化路径键嵌套对象对象转换递归修改时间：2026-06-09 18:09:29