You need to enable JavaScript to run this app. 如何创建仅含指定固定数字属性的TypeScript接口
优惠活动
大模型
产品
解决方案
定价
更多

如何创建仅含指定固定数字属性的TypeScript接口

实现方法

你想写的那种显式列数字属性的接口写法,本身就是TypeScript原生支持的合法语法,完全可以直接用,不需要绕索引签名。

基础接口定义

直接按你想要的结构写就行,没有任何语法限制:

export interface IField {
  123: string;
  124: string;
  125: string;
  126: string;
}

这个定义的校验规则

  • 赋值给该类型的对象,必须完整包含这4个属性,缺一个就报类型错误
  • 对象不能携带这4个键之外的任何额外属性,多写没定义的键也会触发校验失败
  • 每个属性的值必须符合声明的string类型

和全量数字索引签名的差异

你之前用的{ [fieldId: number]: string }是宽范围索引签名,会允许任意合法数字作为对象属性键,没有边界约束;而显式列属性的写法是精确属性校验,完全匹配“只允许这四个指定数字作为属性键”的需求。

实用注意点

  • 访问这些数字属性的时候,优先用方括号语法传数字键,兼容性最好:
const testObj: IField = {
  123: "test value",
  124: "test value",
  125: "test value",
  126: "test value",
}

// 推荐的访问写法
const val = testObj[123];
  • 如果固定的键集合是从常量定义衍生的,不想手写interface,可以用映射类型生成完全等效的类型:
// 提前定义允许的数字键集合
const allowedKeys = [123, 124, 125, 126] as const;
type KeyUnion = typeof allowedKeys[number];

// 自动生成和手写interface效果完全一致的类型
type IField = Record<KeyUnion, string>;

内容的提问来源于stack exchange,提问作者Sushil Adokar

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.24 21:54:01