TypeScript如何定义支持联合键自动补全且允许额外可选键的Record类型

问题原因 #

当你直接把字符串字面量联合类型和string做联合时，TypeScript会自动执行类型简化，将整个联合类型收窄为纯string类型，预设的字面量值信息会被完全擦除，自然就没有对应的自动补全提示了。

实现方案 #

这里提供两种常用的实现方式，都可以满足保留预设键补全+支持任意字符串键的需求：

方案1：用 string & {} 避免类型简化

这是TypeScript生态中比较通用的小技巧，string & {} 本质上还是string类型，但不会触发TS的联合类型简化逻辑：

type Words = 'man' | 'sun' | 'person' | (string & {})
type Dictionary = Record<Words, string>

写完后IDE就会正常提示man/sun/person三个预设键，同时也允许传入其他任意字符串作为键。

方案2：显式交叉预设键和索引签名

如果需要更清晰的语义，明确区分预设键和通用任意键，更推荐用交叉类型实现：

• 如果预设键为必填项：

type Words = 'man' | 'sun' | 'person'
type Dictionary = Record<Words, string> & {
  [key: string]: string
}

• 如果预设键为可选项：

type Words = 'man' | 'sun' | 'person'
type Dictionary = Partial<Record<Words, string>> & {
  [key: string]: string
}

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