TypeScript中类构造函数的data参数应定义为何种类型？

一、基础解决方案：定义匹配的接口/类型别名 #

直接为构造函数的data参数定义包含name和age属性的类型，替代any或object，让TypeScript明确参数结构：

方法1：使用接口

// 定义与类属性匹配的接口
interface PersonData {
  name: string;
  age: number;
}

export class People {
  name: string;
  age: number;

  constructor(data: PersonData) {
    this.name = data.name;
    this.age = data.age;
  }
}

方法2：使用类型别名

如果结构简单，也可以用类型别名替代接口：

type PersonData = {
  name: string;
  age: number;
};

export class People {
  name: string;
  age: number;

  constructor(data: PersonData) {
    this.name = data.name;
    this.age = data.age;
  }
}

修改后既消除了any带来的类型不安全问题，也能直接传入服务器返回的JSON对象（只要结构符合PersonData）：

const data = await fetchData();
const person = new People(data);

二、同时支持对象传参和独立参数传参 #

如果需要兼容传入JSON对象和传入独立name、age参数两种方式，可以使用构造函数重载：

export class People {
  name: string;
  age: number;

  // 重载签名1：传入完整对象
  constructor(data: { name: string; age: number });
  // 重载签名2：传入独立参数
  constructor(name: string, age: number);
  // 实际实现逻辑
  constructor(arg1: string | { name: string; age: number }, arg2?: number) {
    if (typeof arg1 === 'object') {
      // 处理对象传参
      this.name = arg1.name;
      this.age = arg1.age;
    } else {
      // 处理独立参数传参
      this.name = arg1;
      this.age = arg2!; // 重载签名已限制参数数量，此处断言arg2存在
    }
  }
}

两种调用方式均无TypeScript错误：

// 方式1：传入服务器JSON数据
const data = await fetchData();
const person1 = new People(data);

// 方式2：直接传入name和age
const person2 = new People('Bob', 25);

为什么用object类型会报错？ #

TypeScript的object类型仅表示非原始类型（即不是string/number/boolean/symbol/null/undefined），但不包含任何具体属性定义。直接访问data.name或data.age时，TypeScript无法确认这些属性存在，因此会抛出错误。必须明确指定参数的属性结构，才能安全访问属性。

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