如何通过JavaScript字符串路径动态访问嵌套对象或调用函数

在JavaScript项目开发中，经常需要根据字符串形式的路径动态操作嵌套对象，比如从后台返回的深层数据结构中取值，或者根据配置文件中的路径调用对应的方法。直接通过点语法无法处理动态路径，因此需要专门的实现方案。

基础实现思路

实现字符串路径动态访问的核心步骤分为三步：首先拆分路径字符串得到每一层的属性名，然后逐层遍历嵌套对象，最后根据目标类型决定是返回值还是调用函数。

路径拆分逻辑

常见的路径格式有两种，一种是用点分隔的a.b.c格式，另一种是用方括号包裹的a[0].b格式，我们可以通过正则统一拆分出所有属性名：

// 拆分路径字符串，支持点分隔和方括号格式
function splitPath(pathStr) {
  // 匹配点分隔的部分，以及方括号中的内容，过滤空字符串
  return pathStr.match(/[^.[]]+/g) || [];
}
// 测试用例
console.log(splitPath('user.info.name')); // ["user", "info", "name"]
console.log(splitPath('list[0].title')); // ["list", "0", "title"]

动态访问对象属性

拆分路径后，我们需要逐层访问对象，同时做好空值校验，避免访问不存在的属性时报错：

/**
 * 通过字符串路径动态访问嵌套对象属性
 * @param {Object} obj 目标嵌套对象
 * @param {String} path 路径字符串
 * @param {*} defaultValue 路径不存在时的默认返回值
 * @returns {*} 路径对应的值
 */
function getByPath(obj, path, defaultValue = undefined) {
  const keys = splitPath(path);
  let current = obj;
  for (const key of keys) {
    // 如果当前值为null或undefined，直接返回默认值
    if (current == null) {
      return defaultValue;
    }
    // 转换为数字下标，适配数组场景
    const currentKey = isNaN(Number(key)) ? key : Number(key);
    current = current[currentKey];
  }
  // 最终值为undefined时返回默认值
  return current === undefined ? defaultValue : current;
}
// 测试对象
const testObj = {
  user: {
    info: {
      name: '张三',
      age: 25
    }
  },
  list: ['a', 'b', 'c']
};
console.log(getByPath(testObj, 'user.info.name')); // 张三
console.log(getByPath(testObj, 'list[1]')); // b
console.log(getByPath(testObj, 'user.info.gender', '未知')); // 未知

动态调用函数实现

如果路径最终指向的是一个函数，我们还需要支持调用该函数，并且可以传入自定义参数。需要在取值后判断类型，若为函数则执行调用：

/**
 * 通过字符串路径动态访问嵌套对象并调用函数
 * @param {Object} obj 目标嵌套对象
 * @param {String} path 路径字符串
 * @param {Array} args 调用函数时传入的参数数组
 * @param {*} defaultValue 路径不存在或不是函数时的默认返回值
 * @returns {*} 函数执行结果或默认值
 */
function callByPath(obj, path, args = [], defaultValue = undefined) {
  const value = getByPath(obj, path, defaultValue);
  // 判断是否为函数，是则调用并传入参数
  if (typeof value === 'function') {
    return value.apply(obj, args);
  }
  // 不是函数则返回默认值
  return defaultValue;
}
// 测试对象包含函数
const testObjWithFunc = {
  user: {
    getInfo: function(format) {
      return format === 'full' ? '姓名：张三，年龄：25' : '张三';
    }
  }
};
console.log(callByPath(testObjWithFunc, 'user.getInfo', ['full'])); // 姓名：张三，年龄：25
console.log(callByPath(testObjWithFunc, 'user.getInfo', [])); // 张三
console.log(callByPath(testObjWithFunc, 'user.getName', [], '默认名')); // 默认名

边界情况处理

实际使用中还需要处理一些特殊场景，比如路径为空、对象为原始类型、属性名包含特殊字符等情况：

• 如果传入的路径为空字符串，直接返回原对象
• 如果遍历过程中遇到原始类型（非对象/数组），直接终止遍历返回默认值
• 如果属性名包含点或者方括号，需要提前对路径进行转义处理，避免拆分错误

以下是优化后的完整工具函数，覆盖了常见边界情况：

function splitPath(pathStr) {
  if (typeof pathStr !== 'string' || pathStr.trim() === '') {
    return [];
  }
  return pathStr.match(/[^.[]]+/g) || [];
}

function getByPath(obj, path, defaultValue = undefined) {
  if (typeof path !== 'string' || path.trim() === '') {
    return obj;
  }
  const keys = splitPath(path);
  let current = obj;
  for (const key of keys) {
    // 原始类型直接终止遍历
    if (typeof current !== 'object' && typeof current !== 'function') {
      return defaultValue;
    }
    if (current == null) {
      return defaultValue;
    }
    const currentKey = isNaN(Number(key)) ? key : Number(key);
    current = current[currentKey];
  }
  return current === undefined ? defaultValue : current;
}

function callByPath(obj, path, args = [], defaultValue = undefined) {
  const value = getByPath(obj, path, defaultValue);
  if (typeof value === 'function') {
    return value.apply(obj, args);
  }
  return defaultValue;
}

使用场景举例

这个工具函数可以应用在多个场景中：

• 处理后台返回的深层嵌套数据，避免多层判断obj && obj.a && obj.a.b
• 动态表单配置中，根据配置的字段路径获取对应值
• 权限配置中，根据路径判断是否拥有对应操作权限
• 插件系统中，根据字符串标识调用对应的注册方法

JavaScript动态访问对象字符串路径嵌套对象函数调用修改时间：2026-06-11 00:57:23