TypeScript中如何动态访问命名空间的成员？

场景重现 #

先看不可修改的外部定义文件 tsDemoTypes.d.ts：

declare namespace VehicleTypes {
  export interface Helicopter {
    type: 'helicopter';
    maxAltitude: number;
  }

  export interface Airplane {
    type: 'airplane';
    maxSpeed: number;
  }

  export interface Submarine {
    type: 'submarine';
    maxDepth: number;
  }

  export type ValidName = 'Helicopter' | 'Airplane' | 'Submarine';
}

在 tsDemo.ts 中尝试构建动态映射类型时会触发 ts(2709) 错误：

import type * as VehicleTypes from './tsDemoTypes';

// 报错：不能使用索引访问类型来访问命名空间类型
type MoverMap = {
  [K in VehicleTypes.ValidName]: VehicleTypes[K];
};

错误核心原因：TypeScript 不允许直接通过索引签名访问命名空间类型，必须先将其转换为普通的可索引对象类型。

解决步骤 #

1. 转换命名空间类型为可索引接口 #

利用 typeof 操作符获取命名空间的类型结构，将其转换为 TypeScript 可识别的可索引类型：

import type * as VehicleTypes from './tsDemoTypes';

// 把命名空间类型转换成可索引的映射类型
type VehicleTypeMap = typeof VehicleTypes;

2. 构建动态映射类型 #

现在可以用 VehicleTypeMap 安全地构建 MoverMap，不会再触发类型错误：

type MoverMap = {
  [K in VehicleTypes.ValidName]: VehicleTypeMap[K];
};

3. （可选）运行时动态访问成员值 #

如果需要在运行时动态获取命名空间的成员（而非仅类型），要注意导入时去掉 type 关键字（确保导入运行时值）：

// 同时导入类型和运行时值
import * as VehicleTypes from './tsDemoTypes';

type VehicleTypeMap = typeof VehicleTypes;
type MoverMap = {
  [K in VehicleTypes.ValidName]: VehicleTypeMap[K];
};

// 动态获取成员的函数
function getVehicleType<K extends VehicleTypes.ValidName>(name: K): VehicleTypeMap[K] {
  return VehicleTypes[name];
}

完整可运行示例 #

修改后的 tsDemo.ts：

import * as VehicleTypes from './tsDemoTypes';

// 转换命名空间类型为可索引结构
type VehicleTypeMap = typeof VehicleTypes;

// 构建动态映射的MoverMap
type MoverMap = {
  [K in VehicleTypes.ValidName]: VehicleTypeMap[K];
};

// 示例：动态创建对应类型的实例
function createVehicle<K extends VehicleTypes.ValidName>(name: K, props: Omit<VehicleTypeMap[K], 'type'>): VehicleTypeMap[K] {
  return {
    type: name.toLowerCase() as VehicleTypeMap[K]['type'],
    ...props
  } as VehicleTypeMap[K];
}

// 使用示例
const myHelicopter = createVehicle('Helicopter', { maxAltitude: 10000 });
console.log(myHelicopter); // 输出：{ type: 'helicopter', maxAltitude: 10000 }

关键说明 #

• 命名空间类型本身是特殊的类型容器，无法直接索引，通过 typeof 可以将其解构为普通对象类型，从而支持索引访问。
• ValidName 联合类型起到了类型守卫的作用，确保我们只会访问命名空间中存在的有效成员，避免无效索引导致的错误。

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