TypeScript：定义同时包含动态键与静态键的接口

你遇到的这个问题是TypeScript索引签名的典型特性——当你在接口里定义了[key: string]: string这类索引签名后，TypeScript会强制要求所有显式声明的属性类型都必须兼容于索引签名的类型，这就是为什么你的isExchange（boolean类型）和selectedVariant（Variant类型）会触发类型错误。

这里有几种实用的解决方式：

1. 用交叉类型分离动态键与固定属性 #

把动态键的规则和固定属性拆成两个独立的类型，再通过交叉类型（&）合并，既能保留动态键的灵活性，又能让固定属性维持各自的类型：

// 单独定义动态键的规则：任意字符串键对应string值
interface DynamicStringKeys {
  [key: string]: string;
}

// 定义固定属性的类型
interface FixedReturnProperties {
  isExchange?: boolean;
  returnType?: ReturnType; // 假设ReturnType是你已定义的枚举/自定义类型
  selectedVariant: Variant; // 假设Variant是你已定义的类型
}

// 合并成最终的ReturnData类型
type ReturnData = DynamicStringKeys & FixedReturnProperties;

合并后的类型会同时支持：

• 任意字符串键对应string类型的值
• 固定属性保持原本的类型（boolean、ReturnType、Variant）

2. 用Record类型简化动态键定义 #

如果觉得拆分接口太繁琐，你可以直接用Record类型替代动态键的接口定义，写法更简洁：

type ReturnData = Record<string, string> & {
  isExchange?: boolean;
  returnType?: ReturnType;
  selectedVariant: Variant;
};

Record<string, string>和[key: string]: string的接口效果完全一致，只是语法更紧凑。

3. 更精确的动态键约束（可选） #

如果你的动态键是特定格式的（比如示例中的数字字符串，像"8533864186048"），可以用模板字面量类型约束动态键的格式，让类型定义更精准：

// 约束动态键必须是数字转成的字符串
type NumericStringKey = `${number}`;

type ReturnData = Record<NumericStringKey, string> & {
  isExchange?: boolean;
  returnType?: ReturnType;
  selectedVariant: Variant;
};

注意事项 #

• 要确保动态键的名称不会和固定属性的名称重复，否则会出现类型冲突（比如如果有一个动态键叫isExchange，它的类型是string，而固定属性isExchange是boolean，TypeScript会直接报错）。
• 访问ReturnData类型的属性时，TypeScript会正确推断类型：固定属性用定义的类型，动态键则是string类型。

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