如何使用class-transformer正确转换序列化对象的字段名称

@Expose({ name: 'page_view' })配置未生效、字段名保留原属性名，核心由两个问题导致：

• 转换逻辑未走class-transformer的序列化流程，要么用了原生JS对象转换方式，要么调用API时未传必要配置，装饰器的字段映射规则完全没触发
• 装饰器顺序错误，@Transform值转换逻辑执行时机晚于字段映射逻辑，导致别名配置无法匹配转换后的值

1. 调整DTO装饰器顺序，值转换逻辑@Transform要放在更靠近属性的位置（装饰器执行顺序为从下到上，保证值先处理完再走字段映射），修正后的DTO代码如下：

import { Expose, Transform } from 'class-transformer';
import { IsEnum, IsString } from 'class-validator';
// 按项目实际路径引入枚举和类型
import { CategoryEnum } from './enums/category.enum';
import { PageView } from './interfaces/page-view.interface';

export class CreatePageGroupsDto {
  @IsString()
  @Expose()
  name: string;

  @IsString()
  @Expose()
  url: string;

  @IsEnum(CategoryEnum)
  @Expose()
  category: CategoryEnum;

  @Expose({ name: 'page_view' })
  @Transform(({ value = false }) => {
    const pageView: PageView = { stand_alone: value };
    return pageView;
  })
  stand_alone?: boolean;
}

2. 转换类实例为普通对象时，必须使用class-transformer提供的instanceToPlain方法（旧版API为classToPlain），同时开启excludeExtraneousValues: true配置，强制只序列化带@Expose装饰器的字段，并识别装饰器上配置的别名作为输出字段名：

import { instanceToPlain } from 'class-transformer';

// dtoInstance为你创建的CreatePageGroupsDto类实例
const plainObject = instanceToPlain(dtoInstance, {
  excludeExtraneousValues: true,
});

• 禁止用原生对象展开{...dtoInstance}、JSON.parse(JSON.stringify(dtoInstance))这类方式做转换，这类操作不会触发class-transformer的装饰器逻辑，只会保留类的原始属性名。
• 如果你在NestJS项目中使用，需要在接口方法上添加@SerializeOptions({ excludeExtraneousValues: true })装饰器，或在全局配置ClassSerializerInterceptor时传入该配置，才能让接口返回时自动应用字段名映射规则。
• 不要给@Expose添加toClassOnly: true配置，该配置会让别名规则只在普通对象转类实例（反序列化）阶段生效，序列化阶段会被忽略。

按上述配置转换后，输出的对象结构完全匹配预期：

{
  "name": "string",
  "url": "string",
  "category": "legal",
  "page_view": {
    "stand_alone": false
  }
}

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