TypeScript索引签名用于约束对象的动态键值类型，语法为[key: string|number]: ValueType；支持联合字面量+索引签名或Record映射类型增强安全性；需注意兼容性、数量限制及运行时存在性检查。
在 TypeScript 中，索引签名（Index Signature）是用来声明对象可以接受动态字符串（或数字）作为键，并统一约束其值类型的语法。它解决的核心问题是：如何让一个对象既能用任意字符串当 key 访问，又不失去类型安全。
定义索引签名的基本语法
索引签名写在接口或类型别名中，格式为 [key: Type]: ValueType，其中 key 是占位符（名字任意），Type 必须是 string 或 number（TypeScript 4.9+ 也支持 symbol），ValueType 是所有键对应值的类型。
例如：
interface UserMap {
[id: string]: { name: string; age: number };
}
const users: UserMap = {
'1': { name: 'Alice', age: 30 },
'2': { name: 'Bob', age: 25 }
};
// ✅ 允许任意字符串 key
users['3'] = { name: 'Charlie', age: 35 };
// ❌ 类型错误：值必须匹配结构
users['4'] = 'invalid'; // Type 'string' is not assignable to type '{ name: string; age: number; }'
限制允许的键名范围（联合字面量 + 索引签名）
纯索引签名会过于宽松（比如允许 users['xxx'] 即使 'xxx' 实际不存在）。若希望只允许特定字符串键，同时保留动态访问能力，可结合 字符串字面量联合类型 和索引签名：
- 先定义合法键的集合，如
type ValidKey = 'name' | 'email' | 'avatar' - 再用映射类型或接口约束：接口中显式列出这些 key，并用索引签名兜底未枚举的 key（通常设为
never或更宽泛类型） - 更推荐方式是使用 映射类型 + keyof 配合
Record
安全写法示例（推荐）：
type UserFields = 'name' | 'email' | 'avatar';
type User = Record<UserFields, string> & { [key: string]: string };
const user: User = {
name: 'Alice',
email: 'a@example.com',
avatar: '/a.png',
// ✅ 允许额外字段，但值必须是 string
'custom-tag': 'vip'
};
安全读取动态键名（避免类型断言和运行时错误）
直接用 obj[key] 读取时，TypeScript 默认推导出的是索引签名声明的类型（如 string），但无法保证该 key 实际存在。要真正安全，需配合类型守卫或工具函数：
- 用
keyof typeof obj获取对象实际拥有的键（适用于已知结构的对象） - 对动态输入的 key，先检查是否在对象中：
if (key in obj)—— 这会触发 TypeScript 的 in 操作符类型收窄，之后obj[key]类型被精确推导 - 封装一个安全获取函数，返回
T[keyof T] | undefined，并利用泛型保持类型推导
例如：
function safeGet<T extends Record<string, any>>(obj: T, key: string): T[keyof T] | undefined {
return key in obj ? obj[key as keyof T] : undefined;
}
const data = { a: 123, b: 'hello' };
safeGet(data, 'a'); // number | undefined
safeGet(data, 'c'); // number | undefined（因为 keyof data 是 'a' | 'b'，'c' 不在其中，返回 undefined）
注意事项与常见陷阱
索引签名不是万能的，需注意以下几点：
- 一个类型中最多只能有一个字符串索引签名和一个数字索引签名；不能同时有
[k: string]和[k: number]除非数字键能被字符串键覆盖（因为数字 key 会被自动转成字符串） - 如果接口中已有具体属性，索引签名的值类型必须兼容这些属性的类型（例如已有
id: number，那[k: string]: string就会报错） - 使用
as const推导字面量类型时，索引签名不会自动识别新增 key，需手动维护或改用Record - 在 class 中定义索引签名时，仅对实例属性生效，不影响方法或私有成员
不复杂但容易忽略。
