TypeScript：如何通过装饰器自动为类添加id属性（无需手动实现接口）

好问题！在TypeScript里要实现装饰器自动给类注入id属性，同时让类型系统自动识别这个属性，得同时搞定两部分：运行时的属性注入，以及类型系统的类型补全——毕竟TypeScript默认不会自动感知装饰器给类带来的类型变化。下面一步步来实现：

1. 改造装饰器：运行时注入id属性 #

我们可以通过类装饰器返回一个继承原类的新类，在新类的构造函数里初始化id属性（比如生成UUID），这样每个实例都会自动拥有id：

export function Entity(options?: { someOptions: string }) {
  // 使用泛型约束原类的构造函数类型
  return function <T extends new (...args: any[]) => {}>(target: T) {
    // 返回一个继承自原类的新类，添加id属性
    return class extends target {
      id: string;

      constructor(...args: any[]) {
        super(...args);
        // 初始化id，这里用浏览器的crypto API生成UUID，也可以用其他方式
        this.id = crypto.randomUUID();
      }
    };
  };
}

2. 类型补全：让TypeScript自动识别id属性 #

上面的代码已经能在运行时给实例添加id，但TypeScript的类型系统还不知道这个变化——这也是为什么原来需要手动implements EntityInterface的原因。我们可以通过泛型类型断言，让装饰器返回的类自动带上id的类型：

// 定义一个类型，让被装饰的类同时拥有原类的属性和id
type EntityAugmentedClass<T> = T & { new (...args: any[]): { id: string } };

export function Entity(options?: { someOptions: string }) {
  return function <T extends new (...args: any[]) => {}>(target: T): EntityAugmentedClass<T> {
    return class extends target {
      id: string;

      constructor(...args: any[]) {
        super(...args);
        this.id = crypto.randomUUID();
      }
    } as EntityAugmentedClass<T>;
  };
}

3. 使用方式：无需手动声明id或实现接口 #

现在用装饰器修饰你的Product类时，既不用手动写id属性，也不用implements接口，TypeScript会自动识别id的存在：

@Entity({ someOptions: "foobar" })
export class Product {
  title: string;
  price: number;

  constructor(title: string, price: number) {
    this.title = title;
    this.price = price;
  }
}

// 测试：TypeScript会自动提示product.id，且类型为string
const product = new Product("TS装饰器指南", 99);
console.log(product.id); // 输出类似 "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed"
console.log(product.title); // 正常访问原类属性

关键说明 #

• 类装饰器的本质是替换原类：我们返回的新类继承了原类的所有属性和方法，同时添加了id，所以原类的功能不受影响。
• 类型系统的适配：通过EntityAugmentedClass泛型，我们告诉TypeScript“被这个装饰器修饰的类，实例会额外拥有id属性”，避免了手动实现接口的繁琐。
• 初始化逻辑：你可以根据需求修改id的初始化方式，比如从后端获取、用自定义的ID生成器等，不一定非要用UUID。

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