TypeScript 怎么用装饰器给类和方法添加元数据？(5.0+)

Question

仓乃文 · Accepted Answer

需要在类方法上添加日志、权限校验、缓存等横切逻辑时，手动在每个方法里写重复代码。装饰器以声明式方式给类和方法添加功能，TS 5.0+ 采用标准装饰器规范，语法更简洁、类型更安全。

方法装饰器：
```typescript
function log(target: any, context: ClassMethodDecoratorContext) {
  const name = String(context.name);
  return function (this: any, ...args: any[]) {
    console.log(`${name} called with`, args);
    const result = target.apply(this, args);
    console.log(`${name} returned`, result);
    return result;
  };
}

class UserService {
  @log
  getUser(id: string) {
    return { id, name: "Tom" };
  }
}
```

类装饰器：
```typescript
function sealed<T extends { new(...args: any[]): {} }>(
  target: T,
  context: ClassDecoratorContext
) {
  Object.seal(target);
  Object.seal(target.prototype);
}

@sealed
class Config {
  readonly env = "production";
}
```

补充说明：
- TS 5.0+ 使用 TC39 标准装饰器，与旧版实验性装饰器不兼容
- 标准装饰器第二个参数是 context 对象，包含 kind、name 等元信息
- 装饰器种类：class、method、getter、setter、field、accessor
- 需要在 tsconfig.json 中不启用 experimentalDecorators（标准装饰器默认可用）
- 常见场景：依赖注入、路由注册、ORM 映射、权限控制