TypeScript中如何判断含字符串/数字索引的对象类型并遍历键？

嘿，这个问题我之前也碰到过，咱们一步步来拆解解决！首先得明确：TypeScript的类型是静态的，运行时还是JavaScript，所以得结合运行时判断和TypeScript类型守卫来实现你想要的效果，同时还要优化一下你的类型定义，让它更准确。

第一步：优化类型定义 #

你原来的IObjectAnyKey联合类型里的{}其实有点“宽泛”——在TypeScript中，{}包含所有非null/undefined的类型，包括数组、普通对象甚至函数。咱们把它拆得更精准：

// 字符串索引对象：键为字符串类型
interface StringKeyedObject {
  [key: string]: any;
}

// 数字索引对象：键为数字类型（数组是这类的典型代表）
interface NumberKeyedObject {
  [key: number]: any;
}

// 无键空对象：确保是真正的空对象，排除其他类型
type EmptyObject = {} & Record<string, never>;

// 最终的联合类型：涵盖数组、字符串索引对象、空对象
type AnyKeyedObject = NumberKeyedObject | StringKeyedObject | EmptyObject;

第二步：编写类型守卫函数 #

类型守卫能让TypeScript在运行时判断后，自动推断出对应的类型，避免类型错误。咱们写三个守卫函数：

1. 判断数字索引对象（数组或自定义数字键对象） #

数组是最常见的数字索引对象，如果你的场景里还有自定义的数字键对象（比如{ 0: 'a', 1: 'b' }），可以调整判断逻辑：

// 判断是否是数组（最常见的数字索引对象）
function isArrayObject(obj: any): obj is NumberKeyedObject {
  return Array.isArray(obj);
}

// 如果需要支持自定义数字键对象（非数组），可以用这个：
function isNumberKeyedObject(obj: any): obj is NumberKeyedObject {
  // 排除数组、null，然后检查所有键是否能转为有效数字
  return typeof obj === 'object' && obj !== null && !Array.isArray(obj)
    && Object.keys(obj).every(key => !isNaN(Number(key)));
}

2. 判断字符串索引对象 #

普通对象（非数组、非空）就是字符串索引对象：

function isStringKeyedObject(obj: any): obj is StringKeyedObject {
  return typeof obj === 'object' && obj !== null && !Array.isArray(obj)
    && Object.keys(obj).length > 0;
}

3. 判断无键空对象 #

检查对象是否真的没有可枚举键：

function isEmptyObject(obj: any): obj is EmptyObject {
  return typeof obj === 'object' && obj !== null && !Array.isArray(obj)
    && Object.keys(obj).length === 0;
}

第三步：在函数中使用类型守卫 #

现在你可以在处理函数里，用这些守卫分情况遍历对象的键了：

function processItems(items: AnyKeyedObject[]) {
  for (const item of items) {
    if (isArrayObject(item)) {
      // TypeScript自动推断item是数组（数字索引）
      console.log('处理数字索引对象（数组）：');
      item.forEach((value, index) => {
        console.log(`索引 ${index}：${value}`);
      });
    } else if (isNumberKeyedObject(item)) {
      // 处理自定义数字键对象（非数组）
      console.log('处理自定义数字索引对象：');
      Object.keys(item).forEach(key => {
        const numKey = Number(key);
        console.log(`索引 ${numKey}：${item[numKey]}`);
      });
    } else if (isStringKeyedObject(item)) {
      // TypeScript自动推断item是字符串索引对象
      console.log('处理字符串索引对象：');
      Object.keys(item).forEach(key => {
        console.log(`键 ${key}：${item[key]}`);
      });
    } else if (isEmptyObject(item)) {
      // 处理无键空对象
      console.log('这是一个无键的空对象，无需遍历');
    }
  }
}

// 测试用例
processItems([
  [1, 2, 3], // 数组
  { name: 'Alice', age: 25 }, // 字符串索引对象
  { 0: 'a', 1: 'b' }, // 自定义数字索引对象
  {} // 空对象
]);

注意点 #

• 运行时判断顺序很重要：必须先判断数组，再判断普通对象，因为数组也是typeof obj === 'object'的，会被误判。
• 自定义数字键对象在JavaScript中，键其实会被转为字符串（比如obj[0]等价于obj['0']），所以用Object.keys()拿到的是字符串形式的数字，需要手动转成数字类型。

内容的提问来源于stack exchange，提问作者Alexander Knyazev