能否将负数作为TypeScript索引签名的键？技术问询

AI 小北

2026-6-16

TypeScript数字索引签名无法使用负数键的问题与解决方案

问题现象

定义带有数字类型索引签名的类型：

type MoveNbWithLocation = {     
    [key: number]: string; 
}

初始化时，以下写法可正常通过类型检查：

const initPieceLocation: MoveNbWithLocation = {0: ''};
const initPieceLocation: MoveNbWithLocation = {1.3: ''};

但使用负数键时会触发类型错误：

const initPieceLocation: MoveNbWithLocation = {-1: ''}; // 报错

原因分析

JavaScript对象的键本质仅支持字符串或Symbol类型，TypeScript的数字索引签名[key: number]是语法糖，实际对应可被解析为数字的字符串键：

非负整数、浮点数作为对象字面量键时，TypeScript会自动将其转换为对应字符串，判定为符合数字索引签名规则；
负数作为对象字面量键时，会被直接解析为字符串"-1"，TypeScript的类型检查无法直接将其与数字索引签名匹配，因此报错。

解决方案

方案1：保留数字索引签名，用引号包裹负数键

将负数键转为字符串形式，TypeScript会认可该字符串可被解析为数字，符合索引签名要求：

const initPieceLocation: MoveNbWithLocation = {"-1": ''}; // 可行

方案2：改用字符串索引签名

如果需要兼容更多键类型（包括负数、任意数字字符串），直接使用字符串索引签名，此时所有数字形式的键（无论正负、整数或浮点数）都能正常使用：

type MoveNbWithLocation = {
    [key: string]: string;
};

// 所有写法均可行
const initPieceLocation1: MoveNbWithLocation = {0: ''};
const initPieceLocation2: MoveNbWithLocation = {1.3: ''};
const initPieceLocation3: MoveNbWithLocation = {-1: ''};
const initPieceLocation4: MoveNbWithLocation = {"-2": ''};