TypeScript导入命名空间：字符串变量索引失效，字面量为何可行？

问题场景 #

假设有文件my_file.ts，内容如下：

export const MyThing: CustomType = {
    propertyOne: "name",
    propertyTwo: 2
}
export const AnotherThing: CustomType = {
    propertyOne: "Another",
    propertyTwo: 3
}

在另一文件中导入所有导出项后，尝试通过字符串变量动态查找：

import * as allthings from "dir/folder/my_file"

function doStuff() {
   let currentThing = allthings['MyThing']; // 可行
   let name = 'MyThing';
   let currentThing2 = allthings[name]; // 不可行
}

报错信息：

Element implicitly has an 'any' type because expression of type
'string' can't be used to index type 'typeof
import("dir/folder/my_file")'. No index signature with a parameter of
type 'string' was found on type 'typeof import("dir/folder/my_file")'.

原因解析 #

• 用字符串字面量'MyThing'索引时，TypeScript会直接校验该字面量是否属于allthings的键集合，确认存在后允许访问，类型检查通过。
• 字符串变量name的类型被推断为string，这个类型的范围远大于allthings实际拥有的键（仅MyThing和AnotherThing）。TypeScript无法保证任意字符串都能对应到allthings中的有效键，因此触发类型错误。

解决方法 #

1. 限定变量类型为导出键的联合类型

将变量类型明确指定为allthings的键类型，缩小类型范围：

import * as allthings from "dir/folder/my_file"

function doStuff() {
   const name: keyof typeof allthings = 'MyThing';
   let currentThing2 = allthings[name]; // 类型检查通过
}

2. 给对象添加索引签名

创建带有字符串索引签名的类型，将allthings断言为该类型，允许任意字符串索引：

import * as allthings from "dir/folder/my_file"

type AllThings = typeof allthings;
// 添加索引签名，指定索引返回值为CustomType
const indexedThings: AllThings & { [key: string]: CustomType } = allthings;

function doStuff() {
   let name = 'MyThing';
   let currentThing2 = indexedThings[name]; // 类型检查通过
}

3. 类型断言

直接将变量断言为allthings的键类型，强制通过类型检查：

import * as allthings from "dir/folder/my_file"

function doStuff() {
   let name = 'MyThing';
   let currentThing2 = allthings[name as keyof typeof allthings]; // 类型检查通过
}

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