TypeScript使用Object.keys索引接口类型报隐式any错误问题

• TypeScript中Object.keys()的默认返回类型固定为string[]，不会自动推导为目标对象的键联合类型（即keyof TestModel）。这个是TS的刻意设计：由于结构化类型的特性，TS无法在编译期完全保证运行时的对象不会携带接口未声明的额外属性，因此不会默认收窄keys的类型范围。
• 首次写key: any触发报错，是因为项目开启了noImplicitAny严格校验规则，不允许以隐式any类型的索引访问对象属性，即使显式标注any，在严格模式下索引已知结构的对象依然会抛出类型提示。
• 第二次将key标注为string触发报错，是因为TestModel接口仅声明了4个固定键，没有定义通用字符串索引签名：TS认为任意普通string类型的变量，有可能不在这4个合法键的范围内，直接用data[key]访问可能命中不存在的属性，因此抛出类型错误。

根据使用场景选以下两种方案即可，不要用any逃避类型校验，也不要随意关闭严格模式配置。

方案1：类型断言（推荐，适用于固定结构的对象场景） #

当你明确知道运行时对象完全符合接口定义、不存在额外未知属性时，直接将Object.keys的返回值断言为接口的键类型数组即可，类型最精准：

interface TestModel {
    test: string,
    "test 1": string,
    data: string,
    "data 1": string
}

function getKeyByValue(value: string): keyof TestModel | undefined {
    const data: TestModel = {
        test: "test",
        "test 1": "one Test",
        data: "data",
        "data 1": "one data"
    }

    return (Object.keys(data) as Array<keyof TestModel>).find(key => data[key] === value);
}

这个写法下，返回值类型会被收窄为TestModel的合法键联合类型，后续使用返回值时TS能做完整的类型校验。

方案2：添加索引签名（适用于动态扩展键的对象场景） #

如果你的对象后续可能动态添加同类型的键，可以给接口增加字符串索引签名，明确告知TS所有string类型的键访问都返回string类型值：

interface TestModel {
    [key: string]: string; // 声明通用字符串索引规则
    test: string,
    "test 1": string,
    data: string,
    "data 1": string
}

function getKeyByValue(value: string): string | undefined {
    const data: TestModel = {
        test: "test",
        "test 1": "one Test",
        data: "data",
        "data 1": "one data"
    }

    return Object.keys(data).find(key => data[key] === value);
}

这个写法不需要额外做类型断言，但返回值类型是通用string，无法收窄为固定的键联合类型。

注意：如果对象可能存在重复值，find只会返回第一个匹配的键，这个是JS原生API的逻辑，和类型无关。

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