在TypeScript中如何使用数组中的字符串作为对象键？

问题重现 #

我用for循环从数组中获取字符串，将其作为对象键取值，代码能正常运行，但TypeScript抛出以下错误：

const arr = ['one', 'two'];

const map = {
    one: '值是1',
    two: '值是2'
}

for (let i=0; i < arr.length; i++) {
    const item = arr[i];
    const res = map[item]
    console.log(res)
}

报错信息：

元素隐式拥有 "any" 类型，因为类型为 "string" 的表达式不能用于索引类型 "{ one: string; two: string; }"。
在类型 "{ one: string; two: string; }" 上找不到具有类型为 "string" 的参数的索引签名。(7053)

原因 #

TypeScript默认把['one', 'two']推断为string[]类型，而map的键是明确的字面量'one'和'two'，TS无法确认数组中的string一定是map的有效键，所以抛出类型错误。

解决方案 #

1. 给数组指定精确的字面量类型（推荐）

通过as const让TS推断数组元素为具体的字符串字面量，而非宽泛的string：

const arr = ['one', 'two'] as const;

const map = {
    one: '值是1',
    two: '值是2'
}

for (let i=0; i < arr.length; i++) {
    const item = arr[i];
    const res = map[item] // 类型检查通过
    console.log(res)
}

或者显式声明类型：

type MapKey = 'one' | 'two';
const arr: MapKey[] = ['one', 'two'];

// 后续代码不变

这种方式保留完整类型安全，数组中若出现非map键的元素，TS会直接报错。

2. 给对象添加索引签名

如果对象允许任意字符串键，可添加索引签名放宽类型限制：

const arr = ['one', 'two'];

const map: { [key: string]: string } = {
    one: '值是1',
    two: '值是2'
}

for (let i=0; i < arr.length; i++) {
    const item = arr[i];
    const res = map[item] // 类型检查通过
    console.log(res)
}

注意：此方法会丢失map键的精确类型，访问不存在的键时TS不会提示，适合键不固定的场景。

3. 使用类型断言（临时方案）

若只是临时跳过类型检查，可断言数组元素是map的有效键：

const arr = ['one', 'two'];

const map = {
    one: '值是1',
    two: '值是2'
}

for (let i=0; i < arr.length; i++) {
    const item = arr[i];
    const res = map[item as keyof typeof map] // 断言为map的键类型
    console.log(res)
}

这种方式有风险，若数组中存在map没有的键，TS不会报错，仅适合快速调试或确定数组元素安全的场景。

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