TypeScript函数返回string而非number问题排查与优化方案

为什么声明了number类型，实际值还是string？ #

TypeScript的类型注解只是编译阶段的静态检查约束，不会在运行时自动执行类型转换。你虽然在构造函数参数和类属性里声明了thirdPartyId是number类型，但如果调用Ticket构造函数时传入的是字符串（比如第三方API返回的JSON字符串），在没有额外处理的情况下，运行时this.thirdPartyId依然会保持字符串类型——如果你的TypeScript配置未开启严格模式（strict: false），编译阶段甚至不会报错，直接允许字符串赋值给声明为number的属性。

确保返回number的最优方式 #

最优方案是在构造函数内部完成类型转换，把传入的字符串格式ID转为数字，让类内部的thirdPartyId属性从一开始就是真正的number类型，后续无需重复转换：

export class Ticket {
  private ticketNumber: number;
  private thirdPartyId: number;

  // 允许传入string或number类型的thirdPartyId
  public constructor(ticketNumber: number, thirdPartyId: string | number) {
    this.ticketNumber = ticketNumber;
    // 统一转换为number类型，确保内部存储的是数字
    this.thirdPartyId = typeof thirdPartyId === 'string' ? parseInt(thirdPartyId, 10) : thirdPartyId;
  }

  public getThirdPartyId(): number {
    return this.thirdPartyId;
  }
}

如果能确定传入的thirdPartyId是合法的纯数字字符串（无非法字符），也可以用Number(thirdPartyId)简化转换，但parseInt支持指定进制，逻辑更严谨。

另外建议开启TypeScript的严格模式（在tsconfig.json中设置strict: true），这样当你试图把字符串传入声明为number的参数时，编译阶段就会报错，提前规避这类运行时类型不匹配问题。

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