如何移除TypeScript类实例中新增的非类定义属性？

嘿，这个场景我之前在项目里也碰到过，咱们来拆解一下解决方案：

关于反射获取类Address的字段 #

首先得明确：原生JavaScript的反射API（比如Reflect）没办法直接获取TypeScript类定义的属性。因为TypeScript的类型注解只是编译时的语法糖，编译成JavaScript后，这些类型信息会被完全擦除——运行时的Address类和普通JS类没区别，不存在“类定义的字段”这个元数据。

如果非要通过类似“反射”的方式获取，只能借助编译时工具（比如TypeScript Compiler API或ts-morph）来解析类的源码，提前生成属性列表，但这属于构建阶段的操作，不是运行时的反射。

更优的实现方式（避开创建新实例对比） #

既然创建新实例对比不是最优解，推荐下面几种更高效的方案：

1. 手动维护类的静态属性列表 #

这是最直接、可控的方式，在Address类里新增一个静态只读数组，明确列出所有类定义的属性：

export class Address {
  id: number;
  addrLine1: string;
  addrLine2: string;

  // 手动维护类定义的属性列表
  static readonly allowedKeys: (keyof Address)[] = ['id', 'addrLine1', 'addrLine2'];
}

然后编写清理函数，保留列表内的属性，删除额外属性：

// 原地清理实例（不创建新对象）
function cleanAddress(address: Address): void {
  const allowedKeys = new Set(Address.allowedKeys);
  // 遍历实例的所有自有属性
  Object.keys(address).forEach(key => {
    if (!allowedKeys.has(key as keyof Address)) {
      delete address[key];
    }
  });
}

// 或者返回一个新的干净实例（如果不想修改原对象）
function getCleanAddress(address: Address): Address {
  const cleaned = {} as Address;
  Address.allowedKeys.forEach(key => {
    if (address.hasOwnProperty(key)) {
      cleaned[key] = address[key];
    }
  });
  return cleaned;
}

这种方式的好处是运行时效率极高，而且完全可控，不会因为类的继承、构造函数变化而出错。

2. 用装饰器自动收集属性（进阶方案） #

如果类的属性较多，手动维护列表容易出错，可以借助TypeScript装饰器来自动收集属性：
首先在tsconfig.json中启用装饰器配置：

{
  "compilerOptions": {
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true
  }
}

然后编写装饰器和工具函数：

// 装饰器：标记类的属性
function TrackProperty(target: any, propertyKey: string) {
  // 在类的原型上存储属性列表
  if (!target.constructor.allowedKeys) {
    target.constructor.allowedKeys = [];
  }
  target.constructor.allowedKeys.push(propertyKey);
}

// 应用装饰器到Address类
export class Address {
  @TrackProperty
  id: number;
  @TrackProperty
  addrLine1: string;
  @TrackProperty
  addrLine2: string;
}

之后就可以用和方案1一样的清理函数，直接读取Address.allowedKeys来过滤属性。这种方式避免了手动维护，但需要额外配置装饰器，适合属性较多的场景。

3. 编译时自动生成属性列表（高级方案） #

如果想完全自动化，还可以用TypeScript Compiler API编写一个脚本，在构建时自动读取Address类的定义，生成静态属性列表的代码。这种方式零手动维护成本，但需要额外的构建脚本配置，适合大型项目。

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