SuperAPI AI 工具集

avoid-numeric-index

通用与其它

查看项目

更新于 10-16 00:05

技能介绍

用途:在定义类数组类型时,避免用 number 作为索引签名类型,改用 Array<T>、元组或 ArrayLike<T>。适用于定义类数组类型、理解 JavaScript 数组行为、在数组和对象之间取舍,以及处理数组上的 Object.keys。

主要能力:指出 JavaScript 对象键始终是字符串(数组索引在运行时也是字符串,Object.keys 总返回 string[]),TypeScript 的数字索引只是编译期便于查错的"虚构",会形成错误心智模型。

建议做法:序列用 string[] 或 Array<string>;固定长度用元组如 [number, number];可索引集合用 ArrayLike<T>(含 length 与数字索引签名);只需遍历用 Iterable<T>;稀疏数字键用 Map<number, T>。可用 noUncheckedIndexedAccess 或带边界检查的包装函数实现安全访问。

限制:资料未提供安装命令或具体使用方式步骤。