TypeScript中如何使用泛型类型初始化对象？

我来帮你拆解代码里的问题，然后给出可行的解决方案：

为什么原代码无法运行？ #

你的原代码：

export class MapperObject<V> { 
  public obj: V = {}; 
}

这里有两个核心问题：

1. 泛型V无约束：TypeScript无法确认V是对象类型——它可能是string、number甚至undefined，直接把{}赋值给类型为V的obj，类型完全不兼容，所以会报错。
2. 动态赋值无类型支持：当你尝试this.obj[key] = "1"时，如果V没有定义索引签名（比如是一个只有固定属性的接口），TypeScript会禁止你使用动态键赋值，因为无法保证这个键存在于V的属性集合中。

解决方案：约束泛型+正确初始化 #

我们需要给泛型V添加对象类型的约束，同时用类型断言或构造函数初始化解决赋值问题，分两种场景处理：

场景1：需要严格的类型约束（针对特定结构的对象） #

如果你的V是一个有固定属性的接口，我们可以约束V为对象类型，并提供类型安全的赋值方法：

export class MapperObject<V extends Record<string, unknown>> {
  // 使用类型断言`as V`，因为空对象是大多数对象类型的兼容子集
  public obj: V = {} as V;

  // 类型安全的赋值方法，确保key和value符合V的类型定义
  setValue<K extends keyof V>(key: K, value: V[K]) {
    this.obj[key] = value;
  }
}

// 使用示例
interface User {
  name: string;
  age?: number;
}

const userMapper = new MapperObject<User>();
userMapper.setValue('name', 'Bob'); // 合法
userMapper.setValue('age', 30);     // 合法
// userMapper.setValue('email', 'bob@test.com'); // 报错：email不是User的属性

场景2：需要完全动态的键值对（无固定结构） #

如果你的需求是任意键值对存储，不需要严格的属性约束，可以直接用Record类型定义obj，省去泛型的复杂性：

export class MapperObject {
  // 定义为字符串键+字符串值的对象，可根据需求修改值类型（比如unknown）
  public obj: Record<string, string> = {};

  setValue(key: string, value: string) {
    this.obj[key] = value;
  }
}

// 使用示例
const mapper = new MapperObject();
mapper.setValue('id', '1');
mapper.setValue('name', 'Alice');

注意事项：如果V有必填属性 #

如果V包含必填属性，直接用{} as V会有运行时风险（因为必填属性未初始化），此时建议在构造函数中传入初始值：

export class MapperObject<V extends Record<string, unknown>> {
  public obj: V;

  constructor(initialObj: V) {
    this.obj = initialObj;
  }

  setValue<K extends keyof V>(key: K, value: V[K]) {
    this.obj[key] = value;
  }
}

// 使用示例
interface Product {
  id: string; // 必填属性
  name: string;
}

const productMapper = new MapperObject<Product>({ id: 'p1', name: 'Phone' });

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