什么是接口

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 只对函数类型位置严格,方法参数的检查相对宽松。
  • interface 用来说明对象的结构:有哪些属性、什么类型、哪些方法。
  • 它是编译期概念,编译后被完全擦除,运行时不存在。
  • 判定靠结构而非名字:形状兼容即可赋值;对象字面量会触发多余属性检查。
  • 与 type 的核心差异是声明合并与能否表示联合类型;描述对象优先用 interface。
  • 常用能力:可选 / 只读 / 索引签名 / 函数与构造签名 / 多继承 / 泛型 / implements。

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

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • typescript/什么是接口.txt
  • 最后更改: 2026/10/13 17:02
  • 由 张叶安