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:经过变量中转就不再检查多余属性
两者都能描述对象,多数场景可以互换,差异集中在下面几点:
| 对比项 | 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 只对函数类型位置严格,方法参数的检查相对宽松。