TypeScript中向导入函数传递对象数组的类型处理最佳实践

方式1：直接定义参数结构类型（推荐） #

在list-full-names.ts的函数参数里，直接写出需要的属性结构，不用依赖外部接口。TypeScript会自动校验调用方传入的数组是否匹配该结构，完全不需要导入任何外部类型：

// list-full-names.ts
export function listFullNames(namesList: { firstName: string; lastName: string }[]) {
  return namesList.map(name => `${name.firstName} ${name.lastName}`);
}

调用方的NameProps接口只要包含firstName和lastName两个字符串属性，就能正常传参且通过类型检查。后续如果调用方的接口结构变化，函数这边会立刻提示不匹配，保证类型安全。

方式2：用泛型约束实现灵活匹配 #

如果需要保留调用方数组的额外字段类型，同时确保核心属性存在，可以给函数加泛型约束：

// list-full-names.ts
export function listFullNames<T extends { firstName: string; lastName: string }>(namesList: T[]) {
  return namesList.map(name => `${name.firstName} ${name.lastName}`);
}

这种方式下，调用方传入的数组可以有额外属性（比如age），但必须包含firstName和lastName，既满足函数的类型要求，又不丢失调用方的原始类型信息。

方式3：函数内定义局部类型别名 #

如果参数结构复杂，不想每次写完整结构，可以在函数文件里定义一个仅内部使用的类型别名，不用导出，也不用和调用方的接口关联：

// list-full-names.ts
// 仅当前文件可见的局部类型
type NameItem = {
  firstName: string;
  lastName: string;
};

export function listFullNames(namesList: NameItem[]) {
  return namesList.map(name => `${name.firstName} ${name.lastName}`);
}

这种方式让函数代码更整洁，调用方依然不需要导入任何类型，只要结构匹配就能正常使用。

方式4：类型断言（仅临时场景用，不推荐） #

如果只是临时解决问题，不想修改函数代码，可以在调用方传参时用类型断言，但会丢失部分类型安全——后续调用方接口变化时，函数不会收到错误提示：

// 调用方文件
interface NameProps {
  firstName: string;
  lastName: string;
  age?: number;
}

const names: NameProps[] = [
  { firstName: "John", lastName: "Doe" },
  { firstName: "Jane", lastName: "Smith" }
];

import { listFullNames } from "./list-full-names";
// 断言为函数期望的结构
listFullNames(names as { firstName: string; lastName: string }[]);

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