TypeScript类型不兼容：number无法赋值给1|2|3|4联合类型

报错原因 #

TypeScript自动将defaults对象中的quadrant: 2推断为宽泛的number类型，但工厂函数Options.factory要求参数的quadrant必须是1 | 2 | 3 | 4字面量联合类型，导致类型不兼容报错。

修复方法 #

方法1：为defaults指定明确类型

直接给defaults指定Partial<Options>或更精确的类型，强制TypeScript保留字面量类型：

export const defaults: Partial<Options> = {
  quadrant: 2,
};

const responsive: Options = Options.factory({
  ...defaults,
});

或者使用Pick限定仅包含quadrant属性：

export const defaults: Pick<Options, 'quadrant'> = {
  quadrant: 2,
};

方法2：使用as const断言字面量

通过as const让TypeScript将quadrant推断为具体字面量2，而非number：

export const defaults = {
  quadrant: 2 as const,
};

const responsive: Options = Options.factory({
  ...defaults,
});

也可以对整个对象断言：

export const defaults = {
  quadrant: 2,
} as const;

方法3：放宽工厂函数参数类型（并可选添加运行时校验）

如果希望允许传入宽泛的number类型（只要是1-4的有效值），可以修改工厂函数的参数类型，并可选添加运行时校验确保合法性：

export class Options {
  quadrant?: 1 | 2 | 3 | 4 = 1;
  static factory(options: Partial<Omit<Options, 'quadrant'>> & { quadrant?: number }): Options {
    const defaults: Options = new Options();
    // 可选：运行时校验quadrant是否在合法范围内
    if (options.quadrant && ![1,2,3,4].includes(options.quadrant)) {
      throw new Error('quadrant 必须是 1、2、3 或 4');
    }
    return {
      ...defaults,
      ...options,
    } as Options;
  }
}

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