TypeScript添加额外属性无警告？Map与直接赋值行为差异疑问

1. 对象字面量的新鲜度检查（直接返回/硬编码数组场景） #

当你直接返回对象字面量（比如return { id: 1, extra: 'foo' }）或者在数组里硬编码对象时，TypeScript会触发新鲜度检查（严格对象字面量校验）。这个机制是为了避免你误加类型未定义的属性，它会强制对象字面量完全匹配目标类型结构，不允许出现多余属性。

示例代码：

type ProfileFollowingViewModel = { id: number; name: string };

// 直接返回对象字面量，报错：对象字面量只能指定已知属性，'extra'不在类型'ProfileFollowingViewModel'中
const createModel = (): ProfileFollowingViewModel => {
  return { id: 1, name: 'Alice', extra: 'bar' };
};

// 硬编码数组，同样报错
const models: ProfileFollowingViewModel[] = [{ id: 2, name: 'Bob', extra: 'baz' }];

2. map转换时的结构兼容性（无新鲜度检查） #

用map转换生成对象时，你返回的不是直接的对象字面量，而是一个被传递的对象实例（作为回调返回值）。此时TypeScript会切换到结构兼容性检查，而非新鲜度检查。

TypeScript是基于结构的类型系统：只要对象包含目标类型的所有必填属性且类型匹配，就算有额外属性，也会被判定为兼容——因为联合类型（或普通对象类型）只要求对象具备定义的属性，并不禁止额外属性存在。

示例代码：

type ProfileFollowingViewModel = { id: number; name: string };

const rawData = [{ id: 1, name: 'Alice', extra: 'bar' }, { id: 2, name: 'Bob', extra: 'baz' }];

// map转换，无报错：额外属性被允许
const models: ProfileFollowingViewModel[] = rawData.map(item => ({
  id: item.id,
  name: item.name,
  extra: item.extra // 额外属性不触发警告
}));

3. 移除必填属性必报错的原因 #

不管是直接返回还是map转换，只要移除了类型定义的必填属性，都会触发错误——因为目标类型明确要求这些属性必须存在，新鲜度检查和结构兼容性检查都会强制执行这一规则。

示例代码：

type ProfileFollowingViewModel = { id: number; name: string };

// map转换时移除name，报错：缺少属性'name'
const models: ProfileFollowingViewModel[] = rawData.map(item => ({
  id: item.id
}));

// 直接返回时移除name，同样报错
const createModel = (): ProfileFollowingViewModel => {
  return { id: 1 };
};

总结 #

• 直接返回对象字面量/硬编码数组：启用新鲜度检查，禁止额外属性，确保字面量完全匹配类型。
• map转换返回对象：使用结构兼容性检查，只要满足必填属性要求，允许额外属性存在。
• 移除必填属性：两种场景都会报错，因为类型强制要求必填属性必须存在。

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