如何将TypeScript泛型类型用作对象键并解决类型报错

问题分析 #

你遇到的报错是因为TypeScript默认会将泛型参数T推断为宽泛的string类型，导致返回的对象被识别为{ [x: string]: string }（带有字符串索引签名的类型），而Record<T, string>要求返回对象的属性必须是精确的T类型，两者无法直接匹配。

无断言解决方案 #

以下两种方法都无需使用类型断言，同时能消除报错并保留返回对象的自动补全功能：

方案1：使用const泛型参数（TS 5.0+） #

通过在泛型参数前添加const关键字，让TypeScript将T推断为确切的字面量类型，而非宽泛的string。此时返回的对象字面量会被正确识别为Record<T, string>类型，完全匹配返回值要求。

function myFunc<const T extends string>(key: T): Record<T, string> {
  return { [key]: 'asdf' };
}

// 调用示例
const result = myFunc('username');
// result类型为Record<'username', string>，自动补全会显示username属性

方案2：使用函数重载 #

通过重载签名定义精确的泛型返回类型，实现签名返回宽泛的索引签名类型。TypeScript允许实现签名的返回类型兼容重载签名的返回类型，既满足类型约束，又能保留自动补全。

// 重载签名：指定精确的返回类型
function myFunc<T extends string>(key: T): Record<T, string>;
// 实现签名：返回宽泛的索引签名类型，兼容重载要求
function myFunc(key: string) {
  return { [key]: 'asdf' };
}

// 调用示例
const result = myFunc('email');
// result类型为Record<'email', string>，自动补全正常工作

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