如何为TypeScript函数绑定专属局部类型并在方法定义中使用？

TypeScript 不允许类的方法签名直接引用方法内部定义的类型——因为方法签名属于类作用域，而方法内部的类型属于函数局部作用域，作用域层级更低，签名解析时无法访问内部类型。不过可以通过以下几种方式实现你要的“类型仅属于单个方法，且能用于方法返回值定义”的需求：

方案一：利用返回值类型推断（最简洁） #

省略方法的显式返回类型，让 TypeScript 根据方法内部的返回语句自动推断返回值类型。这样类型可以完全封装在方法内部，不会污染外部作用域：

export class Test {
  public static validateShouldPassTest() {
    type T = { constraints?: { shouldPassT?: string } };
    const errors: T[] = [];
    const error: T = { constraints: { shouldPassT: '' } };
    // 业务逻辑
    error.constraints.shouldPassT = 'bad';
    errors.push(error);
    return errors;
  }

  public static validateShouldPassTest2() {
    type V = { constraints?: { shouldPassV?: string } };
    const errors: V[] = [];
    const error: V = { constraints: { shouldPassV: '' } };
    // 业务逻辑
    error.constraints.shouldPassV = 'bad';
    errors.push(error);
    return errors;
  }
}

方案二：使用静态函数表达式（显式指定返回类型） #

如果需要显式声明返回类型，可以把方法定义为类的静态函数表达式，借助 ReturnType 工具类型让返回类型和内部类型关联：

export class Test {
  public static validateShouldPassTest = (): ReturnType<typeof Test.validateShouldPassTest> => {
    type T = { constraints?: { shouldPassT?: string } };
    const errors: T[] = [];
    const error: T = { constraints: { shouldPassT: '' } };
    error.constraints.shouldPassT = 'bad';
    errors.push(error);
    return errors;
  };

  public static validateShouldPassTest2 = (): ReturnType<typeof Test.validateShouldPassTest2> => {
    type V = { constraints?: { shouldPassV?: string } };
    const errors: V[] = [];
    const error: V = { constraints: { shouldPassV: '' } };
    error.constraints.shouldPassV = 'bad';
    errors.push(error);
    return errors;
  };
}

方案三：类内部局部类型（适合少量类型复用场景） #

如果你的类型需要在类的多个方法中复用，但又不想暴露到全局，可以在类内部定义局部类型，每个方法使用专属的类型：

export class Test {
  // 仅在 Test 类作用域内可见的类型
  private type T = { constraints?: { shouldPassT?: string } };
  private type V = { constraints?: { shouldPassV?: string } };

  public static validateShouldPassTest(): T[] {
    const errors: T[] = [];
    const error: T = { constraints: { shouldPassT: '' } };
    error.constraints.shouldPassT = 'bad';
    errors.push(error);
    return errors;
  }

  public static validateShouldPassTest2(): V[] {
    const errors: V[] = [];
    const error: V = { constraints: { shouldPassV: '' } };
    error.constraints.shouldPassV = 'bad';
    errors.push(error);
    return errors;
  }
}

以上三种方案中，方案一最贴合你“类型仅专属单个方法”的需求，代码简洁且完全封装了内部类型。

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