如何让TypeScript允许将null作为索引类型？

TypeScript默认不允许null作为索引类型，但JavaScript里实际会把null转成字符串"null"作为对象键存储。针对你不能修改原有对象的情况，有几种实用方法绕开TS的类型检查，同时符合运行时实际行为：

1. 访问时用类型断言 #

直接在访问null键时，把null断言成字符串类型——因为JS里对象实际存储的是"null"键：

const obj = { [null]: "test value", 123: "num value" };
// 用断言绕过TS检查
const nullValue = obj[null as unknown as string];

这种方式不需要修改对象本身，完全适配对象不能改动的场景。

2. 给对象指定包含"null"键的类型 #

如果能给对象添加类型定义，直接把"null"纳入键的合法范围：

// 定义包含普通字符串键和"null"键的类型
type NullKeyObj = Record<string | "null", string>;

// 给对象指定类型，用as const保留字面量类型
const obj: NullKeyObj = {
  [null]: "test value",
  123: "num value"
} as const;

// 此时两种访问方式都合法
const val1 = obj["null"];
const val2 = obj[null as unknown as string];

这种方式更贴合类型安全原则，TS会直接认可"null"作为合法键。

为什么数字可以直接用？ #

TypeScript对数字索引做了特殊适配：数字作为索引时会被自动转换为字符串类型，所以TS允许数字直接作为键访问。而null没有这个默认转换逻辑，因此需要手动映射到对应的字符串键"null"。

内容的提问来源于stack exchange，提问作者Jeff