如何在类型安全的前提下逐步构建包含必填字段的TypeScript对象

这个场景我太熟悉了——为了绕开TypeScript对必填属性的检查，先用Partial<User>临时存储，最后靠as User断言返回，结果就是：哪怕漏填了某个必填字段，TS也一声不吭，等到运行时才出问题。下面给你几个实用方案，既能保留逐步构建的灵活性，又能让TS严格把关必填字段：

方案1：用类型守卫函数做编译+运行时双重校验 #

写一个类型守卫函数，专门检查对象是否符合User的完整类型。构建完成后必须通过这个守卫的检查才能返回对象，不管是编译时漏填还是运行时意外，都能被及时发现。

// 定义你的User类型
type User = {
  id: string;
  name: string;
  email: string;
};

// 类型守卫函数：判断传入对象是否是完整的User
function isUser(obj: Partial<User>): obj is User {
  return (
    typeof obj.id === 'string' &&
    typeof obj.name === 'string' &&
    typeof obj.email === 'string'
  );
}

function createUser(options: { id: string; name: string; email: string }) {
  const returnObject: Partial<User> = {};
  
  // 逐步赋值字段
  returnObject.id = options.id;
  returnObject.name = options.name;
  // 故意漏写email试试？下面的if会直接报错
  returnObject.email = options.email;
  
  // 必须通过守卫检查，否则抛出错误
  if (!isUser(returnObject)) {
    throw new Error('构建的User对象缺少必填字段！');
  }
  
  // 这里TS已经自动识别returnObject为User类型，无需再断言
  return returnObject;
}

方案2：用构建器模式封装复杂构建逻辑 #

如果你的对象需要多步骤构建（比如不同条件下设置不同字段），构建器模式会让代码更清晰，同时强制要求所有必填字段都被设置后才能生成最终对象。

type User = {
  id: string;
  name: string;
  email: string;
  // 可选字段示例
  avatarUrl?: string;
};

class UserBuilder {
  private id?: string;
  private name?: string;
  private email?: string;
  private avatarUrl?: string;

  // 必填字段的set方法
  setId(id: string): this {
    this.id = id;
    return this;
  }

  setName(name: string): this {
    this.name = name;
    return this;
  }

  setEmail(email: string): this {
    this.email = email;
    return this;
  }

  // 可选字段的set方法
  setAvatarUrl(url: string): this {
    this.avatarUrl = url;
    return this;
  }

  // 构建方法：必须确保所有必填字段都存在，否则TS编译报错
  build(): User {
    if (!this.id || !this.name || !this.email) {
      throw new Error('User构建不完整：缺少id/name/email中的一个或多个');
    }

    return {
      id: this.id,
      name: this.name,
      email: this.email,
      ...(this.avatarUrl && { avatarUrl: this.avatarUrl }),
    };
  }
}

// 使用示例
function createUser(options: { id: string; name: string; email: string }) {
  const user = new UserBuilder()
    .setId(options.id)
    .setName(options.name)
    .setEmail(options.email)
    // 可选：设置头像
    .setAvatarUrl(`/avatars/${options.id}.png`)
    .build();

  return user;
}

这个模式的好处是：构建步骤一目了然，而且如果漏了某个必填字段的set方法，build()时TS会直接报错（因为this.id等可能是undefined，无法符合User类型要求）。

方案3：纯编译时校验的工具函数 #

如果你只需要编译时检查，不想加运行时代码，可以写一个简单的工具函数，利用TypeScript的类型约束强制对象必须是完整的User类型：

type User = {
  id: string;
  name: string;
  email: string;
};

// 工具函数：仅当传入对象是完整的User时才通过编译
function ensureCompleteUser<T extends User>(user: T): User {
  return user;
}

function createUser(options: { id: string; name: string; email: string }) {
  const returnObject: Partial<User> = {};
  
  returnObject.id = options.id;
  returnObject.name = options.name;
  returnObject.email = options.email;
  
  // 如果returnObject缺少字段，这里会直接编译报错
  return ensureCompleteUser(returnObject as User);
}

注意：这个方案依赖类型断言，但ensureCompleteUser的泛型约束会确保你不能随便把不完整的对象传进去——如果returnObject有字段缺失，as User的断言会被TS识别为不安全，编译时就会提示错误。

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