JavaScript / TypeScript / 系统课时

选择接口或类型别名

选择接口或类型别名

interface 与 type 都能描述对象结构,但它们并非完全等价。本课通过扩展方式、声明合并和联合类型三个关键差异,帮助你为公共契约与局部类型选择更合适的写法。

学习目标

  • 判断对象结构应使用 interface 还是 type
  • 理解声明合并、联合类型与交叉类型的能力边界
  • 避免基于过时规则选择类型声明方式

先看能力边界

需求 interface type
描述对象结构 支持 支持
继承或组合对象 使用 extends 使用交叉类型 &
同名声明自动合并 支持 不支持
定义联合类型 不支持 支持
定义元组、原始类型别名 不支持 支持

两者都适合描述普通对象。真正影响选择的通常不是“能不能定义对象”,而是类型是否需要开放扩展,以及是否涉及联合、元组或其他非对象类型。

主示例:契约与结果类型

下面使用 interface 定义可扩展的用户契约,再使用 type 表达成功或失败两种互斥结果。示例同时展示了两者各自最典型的用途。

ts
interface User {
  id: number;
  name: string;
}

// 同名接口会合并,适合由多个声明共同补充公共契约。
interface User {
  active: boolean;
}

type QueryResult =
  | { ok: true; data: User }
  | { ok: false; error: string };

function formatResult(result: QueryResult): string {
  if (result.ok) {
    return `${result.data.name}: ${result.data.active}`;
  }

  return `Error: ${result.error}`;
}

const result: QueryResult = {
  ok: true,
  data: { id: 1, name: "Ada", active: true }
};

console.log(formatResult(result));

预期输出

text
Ada: true

两个 User 声明最终形成一个同时包含 id、name 和 active 的接口。QueryResult 则必须在成功结构与失败结构之间二选一,使用 type 定义联合类型更直接。

对象扩展的两种方式

接口通过 extends 表达继承关系,阅读时更接近面向对象中的契约扩展。类型别名通常通过交叉类型组合多个对象结构。

ts
interface Identifiable {
  id: number;
}

interface Product extends Identifiable {
  name: string;
}

type Timestamped = {
  createdAt: Date;
};

type ProductRecord = Product & Timestamped;

const product: ProductRecord = {
  id: 10,
  name: "Keyboard",
  createdAt: new Date("2026-08-02T00:00:00Z")
};

console.log(product.name, product.id);

预期输出

text
Keyboard 10

不要把“类型别名不能扩展”当作选择依据。type 可以通过 & 继续组合,interface 也可以继承合适的对象类型;二者主要区别在表达形式和声明是否开放。

实用选择规则

面向库使用者、插件或多个模块公开的对象契约,优先考虑 interface。它的声明合并能力允许后续扩展,也能清晰表达继承关系。

联合类型、元组、函数类型、字面量集合以及原始类型别名,应使用 type。这些结构无法直接由接口表达。

只在单个模块内部使用的普通对象结构,两种方式通常都可以。此时应优先遵循项目已有规范,避免为了风格偏好反复转换声明形式。

易混淆点

声明合并既是能力也是风险。同名接口可能在不同文件中被自动合并,适合扩展第三方声明,但也可能让类型来源变得分散。内部业务模型如果不希望被意外补充,可以使用 type 保持封闭。

不要仅因为错误信息或性能传言强制统一使用某一种声明。现代 TypeScript 对两者都提供了成熟支持,选择应围绕表达意图、扩展方式和实际类型结构。

本课总结

  • 公共且可能扩展的对象契约通常优先使用 interface
  • 联合、元组、字面量集合和非对象别名必须使用 type
  • 普通对象两者都能描述,应结合开放性与项目规范选择

下一课预告

下一课将继续建模对象结构,学习可选属性、只读属性以及索引签名的使用边界。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

选择接口或类型别名

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通