索引签名与固定属性共存时，所有固定属性的类型必须是索引签名值类型的子类型；例如 [key: string]: string 时，name: number 不合法，而 name: string 合法；可选和只读属性不影响该规则，但类型仍须兼容。
直接用索引签名配合确定属性即可，但必须注意类型兼容性——所有固定属性的类型必须能被索引签名的值类型覆盖。
索引签名与固定属性共存的关键规则
接口中同时声明固定属性和索引签名时，TypeScript 要求每个固定属性的值类型必须是索引签名值类型的子类型。否则会报错。
- 比如索引签名写成
[key: string]: string，那么name: number就不合法，因为number不属于string - 但
name: string或title?: string都可以，它们满足约束 - 可选属性（
?）和只读属性（readonly）不影响该规则，只要类型兼容就行
常见安全写法示例
以下是几种生产环境常用、类型安全的组合方式：
-
固定字段 + 宽松动态字段：固定属性用精确类型，索引签名用联合类型覆盖全部可能值
interface ApiResponse {<br> status: "success" | "error";<br> code: number;<br> [key: string]: unknown; // 允许任意额外字段，值类型为 unknown<br>} -
固定字段 + 受限动态字段：索引签名限定为具体类型，固定属性与其一致
interface Config {<br> env: string;<br> timeout: number;<br> [key: string]: string | number | boolean;<br>}
此时env和timeout的类型都在string | number | boolean范围内，合法 -
带只读固定属性的场景：只读不影响索引签名校验，只限制赋值时机
interface User {<br> id: string;<br> readonly createdAt: Date;<br> [key: string]: string | number | Date | undefined;<br>}createdAt类型Date必须在索引签名值类型中出现，否则报错
容易踩坑的错误模式
以下写法会在编译时报错，需避免：
- 索引签名值类型太窄：
[key: string]: string却定义count: number——number无法赋给 - 混用数字和字符串索引且类型冲突：同时声明
[n: number]: string 和 <code>[k: string]: number会导致隐式类型重叠问题，TS 要求二者值类型必须兼容（通常建议只用一种索引类型） - 把索引签名写在确定属性之后却忽略兼容性：顺序不影响规则，但开发者容易疏忽检查
替代方案：映射类型 + keyof 组合（更灵活）
如果固定属性较多或需要复用，可用映射类型避免重复声明：
type FixedKeys = "id" | "name" | "role";type BaseUser = { [K in FixedKeys]: K extends "id" ? string : K extends "name" ? string : "admin" | "user" };
type ExtendedUser = BaseUser & { [key: string]: unknown };
这样既保留了字段的精准类型，又允许扩展任意属性，且无兼容性风险。
