在TypeScript的类型系统中，接口（Interface）和类型别名（Type Alias）都是用来定义复杂类型的工具，很多开发者会混淆两者的用法，也经常会遇到接口触发索引签名报错的情况。下面我们先从基础概念入手，逐步理清两者的差异和报错原因。
接口与类型别名的基础定义
接口是TypeScript专门为对象类型设计的定义方式，用来描述对象的结构，明确对象包含哪些属性、每个属性的类型是什么。类型别名则是给任意类型起一个别名，不仅可以定义对象类型，还可以定义联合类型、元组类型、基础类型等。
两者的基础定义示例如下：
// 接口定义对象类型
interface UserInterface {
name: string;
age: number;
}
// 类型别名定义对象类型
type UserType = {
name: string;
age: number;
};
// 类型别名定义联合类型（接口无法做到）
type Status = 'success' | 'error' | 'loading';两者的核心差异对比
我们可以从多个维度对比接口和类型别名的区别，具体如下表：
| 对比维度 | 接口（Interface） | 类型别名（Type Alias） |
|---|---|---|
| 可定义的类型范围 | 仅支持对象类型、函数类型 | 支持所有TypeScript类型，包括联合类型、交叉类型、元组等 |
| 扩展方式 | 使用extends继承，支持声明合并 | 使用交叉类型&扩展，不支持声明合并 |
| 编译后行为 | 会被编译到声明文件中，可被外部扩展 | 仅作为类型别名存在，不会出现在编译产物中 |
| 索引签名支持 | 合并时要求所有索引签名类型兼容 | 交叉时索引签名需要完全匹配 |
接口为何会出现索引签名错误
索引签名是用来描述对象动态属性类型的语法，比如interface Obj { [key: string]: number }表示对象的任意字符串键对应的值都是number类型。接口出现索引签名错误的核心原因和它的声明合并特性有关。
TypeScript允许同名的接口进行声明合并，合并时会把多个接口的成员合并到一起，如果不同声明中的索引签名类型不兼容，就会触发报错。比如下面的场景：
// 第一个接口声明，索引签名值为number
interface MyObj {
[key: string]: number;
}
// 第二个同名接口声明，索引签名值为string，和第一个不兼容
interface MyObj {
[key: string]: string; // 这里会报错：后续的索引签名必须兼容之前的索引签名
}另外，如果接口中定义了确定属性，同时又有索引签名，确定属性的类型必须是索引签名类型的子集，否则也会报错：
// 索引签名值为number，但是name属性是string类型，不属于number的子集
interface MyObj {
[key: string]: number;
name: string; // 报错：属性name的类型string不能赋值给字符串索引类型number
}类型别名的索引签名表现
类型别名不存在声明合并的特性，所以不会出现合并导致的索引签名冲突问题，但是如果使用交叉类型扩展包含索引签名的类型，也需要满足类型兼容规则：
type Obj1 = {
[key: string]: number;
};
type Obj2 = {
[key: string]: string;
};
// 交叉两个索引签名不兼容的类型，会推导出never类型
type MergeObj = Obj1 & Obj2; // MergeObj的索引签名值会变成never，因为number和string没有交集使用建议
根据两者的特性，我们可以按照以下场景选择使用：
- 如果需要定义对象类型，并且可能需要后续扩展、合并，优先选择接口
- 如果需要定义联合类型、元组类型等非对象类型，或者不需要合并扩展，优先选择类型别名
- 如果接口需要包含索引签名，要确保所有合并的声明中索引签名类型兼容，且确定属性类型是索引签名类型的子集
理解两者的差异和索引签名的规则后，就可以有效避免接口相关的索引签名报错，写出更规范的TypeScript代码。
TypeScript接口类型别名索引签名类型检查修改时间：2026-06-02 04:55:20