TypeScript如何用联合类型键初始化类并支持自动补全

我现在完全被这个问题卡住了。
我首先定义了如下类型：

type Bug = 'hairy' | 'scary' | 'cute' | 'ugly' // 实际场景下可能有上百种Bug类型🪳

接下来我编写了一个类，想要在类中初始化对应属性：

class MeadowWithBugs {
  [key: keyof Bug]: number // <--- 这里直接报类型错误😭
  constructor(){
    this.hairy = 1
    this.cute = 100
    // 期望可以通过this访问所有Bug类型对应的属性，并且获得TS自动补全
  }
  // ...其他和Bug相关的逻辑
}

显然[key: keyof Bug]: number这种写法无法正常运行，会触发多类TypeScript类型错误。
我尝试了几乎所有能想到的方案：

• 用const Bug = [...]定义常量数组，再通过type Bugs = typeof Bug[number]推导联合类型；
• 定义interface Bug { [key: string]: number }接口，再声明const Bugs: Bug = { ugly: 2, ... }常量对象；
• 尝试[key in Bugs]: number等各类映射类型的写法；
• 甚至出门散步放空思路寻找解法。
  这些尝试都没解决问题，最终始终得到两类报错：要么提示An index signature parameter type must be 'string', 'number', 'symbol', or a template literal type.，要么提示An index signature parameter type cannot be a literal type or generic type. Consider using a mapped object type instead.，始终在绕圈子无法解决。
  我曾尝试使用 [key: keyof typeof Bug]: number的写法初始化类，但这种写法会允许任意字符串作为Bug类型的键，完全无法触发自动补全。
  核心诉求：能够便捷地使用Bug联合类型包含的所有键初始化类，在构造函数中通过this关键字访问这些键时可以获得完整的类型自动补全。

报错的本质原因是：TypeScript 类内部的索引签名仅支持string/number/symbol这类通用原始类型，不支持直接传入字面量联合类型做键，也不支持直接在类体内写[key in 联合类型]的映射类型语法，所以之前的写法都会触发类型错误。
可以根据需求选择以下两种实现方式：

方式1：通过implements绑定映射类型（推荐） #

这是类型最严格、自动补全最稳定的写法，适合绝大多数场景。先定义实例需要满足的属性结构，再让类实现这个类型即可：
如果要求必须初始化所有Bug类型对应的属性，直接用Record工具类型生成映射结构：

type Bug = 'hairy' | 'scary' | 'cute' | 'ugly'

class MeadowWithBugs implements Record<Bug, number> {
  hairy: number
  scary: number
  cute: number
  ugly: number

  constructor() {
    this.hairy = 1
    this.cute = 100
    this.scary = 0
    this.ugly = 2
  }
}

如果Bug类型很多、不需要强制初始化所有属性，用Partial把属性转为可选即可，不需要逐个在类中声明属性，输入this.时依然能拿到所有Bug键的自动补全：

type Bug = 'hairy' | 'scary' | 'cute' | 'ugly'

class MeadowWithBugs implements Partial<Record<Bug, number>> {
  constructor() {
    this.hairy = 1 // 输入this.时会自动提示所有Bug类型的键
    this.cute = 100
  }
}

方式2：类类型交叉（适合超大量联合类型场景） #

如果联合类型成员极多，不想做任何额外的属性声明，可以直接通过类型交叉给类指定实例类型，不过这种写法不会做初始化校验，访问未赋值的属性会得到undefined，需要自行做好空值处理：

type Bug = 'hairy' | 'scary' | 'cute' | 'ugly'

const MeadowWithBugs = class {
  constructor() {
    this.hairy = 1
    this.cute = 100
  }
} as new () => Partial<Record<Bug, number>> & {
  // 可以在这里补充类的其他方法、属性的类型定义
}

const meadow = new MeadowWithBugs()
console.log(meadow.hairy) // 有完整类型提示

不要使用[key: string]: number这类宽泛索引签名，它会放弃对键的类型校验，允许任意字符串属性访问，自然也不会有精准的自动补全。

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