typescript:什么是接口

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

typescript:什么是接口 [2026/10/13 17:01] – 创建 张叶安typescript:什么是接口 [2026/10/13 17:02] (当前版本) – 补全「什么是接口」页面:同命名空间「什么是 X」系列风格 张叶安
行 1: 行 1:
-1+====== 什么是接口 ====== 
 + 
 +''interface''(接口)是 TypeScript 用来**描述对象形状**的语法:它列出"这个对象应该有哪些属性、哪些方法,各自的类型是什么"。一个值只要满足这份清单,就被认为属于该接口——**不需要显式声明自己实现了它**。 
 + 
 +<code 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}`; } 
 +}; 
 +</code> 
 + 
 +一句话概括它的作用:**给"对象长什么样"起个名字**,然后在各处复用这个名字,而不是反复写一堆内联类型。 
 + 
 +===== 一、它只活在编译期 ===== 
 + 
 +接口是纯类型层面的东西,**不会产出任何运行时代码**,编译后类型被完全擦除: 
 + 
 +<code typescript> 
 +// 源码 
 +interface Point { x: number; y: number; } 
 +const p: Point = { x: 1, y: 2 }; 
 +</code> 
 + 
 +<code javascript> 
 +// 编译产物:接口已消失 
 +const p = { x: 1, y: 2 }; 
 +</code> 
 + 
 +所以运行时**无法判断**"这个对象是不是 Point"——''instanceof''、''typeof'' 都不认接口。需要运行时校验时,得自己写检查函数,或借助 zod 这类 schema 库。 
 + 
 +===== 二、结构化类型:看形状,不看名字 ===== 
 + 
 +TypeScript 用的是**结构化类型系统**(俗称鸭子类型):只要结构对得上就能赋值,来自哪个类、有没有 ''implements'' 都不重要。 
 + 
 +<code typescript> 
 +interface Named { name: string; } 
 + 
 +class Cat { name = "Tom"; age = 3; } 
 + 
 +const n: Named = new Cat();   // OK:Cat 有 name,结构兼容 
 +</code> 
 + 
 +三条判定规则: 
 + 
 +  * **属性只多做少**:目标接口要求的属性必须都有;多出来的属性一般不算错(见下一条)。 
 +  * **可选属性可以缺**:''email?: string'' 不写也合法。 
 +  * **对象字面量的多余属性检查**:直接把字面量赋给接口变量时,多写的属性会**报错**——这是针对字面量专门做的"防拼写错误"检查。 
 + 
 +<code typescript> 
 +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:经过变量中转就不再检查多余属性 
 +</code> 
 + 
 +===== 三、接口 vs 类型别名(type) ===== 
 + 
 +两者都能描述对象,多数场景可以互换,差异集中在下面几点: 
 + 
 +^ 对比项 ^ ''interface'' ^ ''type'' 别名 ^ 
 +| 描述对象 / 函数类型 | 能 | 能 | 
 +| 联合、交叉、元组、原始类型别名 | **不能** | 能,例如状态联合类型 | 
 +| 声明合并 | **能**(同名自动合并) | 不能,同名直接报错 | 
 +| 继承方式 | ''extends'',可多继承 | 用交叉类型 ''&'' | 
 +| 类实现 | ''implements'' | ''implements'' 也可以 | 
 +| 错误提示 | 一般显示接口名,更短更好读 | 可能展开成完整结构 | 
 +| 使用建议 | 描述对象结构、对外暴露 API 时优先 | 需要联合 / 映射 / 条件类型时用 | 
 + 
 +<code typescript> 
 +// 声明合并:同名接口会被合并,常见于扩展第三方类型 
 +interface Window { title: string; } 
 +interface Window { tsVersion: string; } 
 +// 结果:Window 同时拥有 title 和 tsVersion 
 + 
 +// type 做不到声明合并,但能表示联合类型 
 +type Status = "loading" | "success" | "error"; 
 +</code> 
 + 
 +===== 四、接口能表达什么 ===== 
 + 
 +^ 能力 ^ 写法 ^ 说明 ^ 
 +| 必需属性 | ''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:第五章_接口|第五章:接口]]、[[typescript:第九章_声明合并|声明合并]]、[[typescript:第十五章_工具类型|工具类型]]、[[typescript:第六章_类|类]] 

该主题尚不存在

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

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