什么是接口
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,结构兼容
三条判定规则:
- 属性只多做少:目标接口要求的属性必须都有;多出来的属性一般不算错(见下一条)。
- 可选属性可以缺:
email?: string不写也合法。 - 对象字面量的多余属性检查:直接把字面量赋给接口变量时,多写的属性会报错——这是针对字面量专门做的“防拼写错误”检查。
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 | 检查类是否满足接口 |
五、常见坑
- 以为接口在运行时存在:擦除后什么都没有,别拿它做运行时判断。
readonly只是编译期约束:运行时照样能改,as any之类的断言也能绕过;要真正不可变得靠Object.freeze。- 索引签名会“传染”:一旦写了
[key: string]: string,所有显式属性都必须兼容string,否则报错。 - 空接口 ≠ 任意对象:
interface X {}几乎接受所有非 null 值,想表达“任意对象”用Record<string, unknown>或object。 implements只做结构检查:类不必真的继承什么,但漏掉一个必需属性就会报错;接口里也无法表达类的private成员。- 函数参数的兼容性有历史包袱:
strictFunctionTypes只对函数类型位置严格,方法参数的检查相对宽松。
六、小结
interface用来说明对象的结构:有哪些属性、什么类型、哪些方法。- 它是编译期概念,编译后被完全擦除,运行时不存在。
- 判定靠结构而非名字:形状兼容即可赋值;对象字面量会触发多余属性检查。
- 与
type的核心差异是声明合并与能否表示联合类型;描述对象优先用interface。 - 常用能力:可选 / 只读 / 索引签名 / 函数与构造签名 / 多继承 / 泛型 /
implements。