目录

什么是接口

interface(接口)是 TypeScript 用来描述对象形状的语法:它列出“这个对象应该有哪些属性、哪些方法,各自的类型是什么”。一个值只要满足这份清单,就被认为属于该接口——不需要显式声明自己实现了它。

interface User {
  id: number;
  name: string;
  email?: string;           // 可选
  readonly createdAt: Date; // 只读
  greet(): string;          // 方法
}
 
const u: User = {
  id: 1,
  name: "Alice",
  createdAt: new Date(),
  greet() { return `Hi, ${this.name}`; }
};

一句话概括它的作用:给“对象长什么样”起个名字,然后在各处复用这个名字,而不是反复写一堆内联类型。

一、它只活在编译期

接口是纯类型层面的东西,不会产出任何运行时代码,编译后类型被完全擦除:

// 源码
interface Point { x: number; y: number; }
const p: Point = { x: 1, y: 2 };
// 编译产物:接口已消失
const p = { x: 1, y: 2 };

所以运行时无法判断“这个对象是不是 Point”——instanceof、typeof 都不认接口。需要运行时校验时,得自己写检查函数,或借助 zod 这类 schema 库。

二、结构化类型:看形状,不看名字

TypeScript 用的是结构化类型系统(俗称鸭子类型):只要结构对得上就能赋值,来自哪个类、有没有 implements 都不重要。

interface Named { name: string; }
 
class Cat { name = "Tom"; age = 3; }
 
const n: Named = new Cat();   // OK:Cat 有 name,结构兼容

三条判定规则:

const a: User = { id: 1, name: "A", createdAt: new Date(), age: 20 };
//                                                          ^ Error: 'age' 不在 User 里
 
const raw = { id: 1, name: "A", createdAt: new Date(), age: 20 };
const b: User = raw;   // OK:经过变量中转就不再检查多余属性

三、接口 vs 类型别名(type)

两者都能描述对象,多数场景可以互换,差异集中在下面几点:

对比项 interface type 别名
描述对象 / 函数类型 能 能
联合、交叉、元组、原始类型别名 不能 能,例如状态联合类型
声明合并 能(同名自动合并) 不能,同名直接报错
继承方式 extends,可多继承 用交叉类型 &
类实现 implements implements 也可以
错误提示 一般显示接口名,更短更好读 可能展开成完整结构
使用建议 描述对象结构、对外暴露 API 时优先 需要联合 / 映射 / 条件类型时用
// 声明合并:同名接口会被合并,常见于扩展第三方类型
interface Window { title: string; }
interface Window { tsVersion: string; }
// 结果:Window 同时拥有 title 和 tsVersion
 
// type 做不到声明合并,但能表示联合类型
type Status = "loading" | "success" | "error";

四、接口能表达什么

能力 写法 说明
必需属性 name: string 缺了就报错
可选属性 email?: string 可缺省,读出来是 string 或 undefined
只读属性 readonly id: number 只挡编译期赋值,运行时可改
方法 greet(): string 也可写成属性形式 greet: () ⇒ string
索引签名 [key: string]: number 描述“任意键”,所有属性都要兼容它
函数类型 (x: number): string 接口本身表示一个函数
构造签名 new (h: number): Clock 描述“可被 new 的东西”
继承 interface A extends B, C 支持同时继承多个
泛型 Resp<T> 里写 data: T 接口可以带类型参数
被类实现 class X implements A 检查类是否满足接口

五、常见坑

六、小结

相关:第五章:接口、声明合并、工具类型、类