TypeScript中数组形式的REST API请求头类型校验问题

你遇到的问题其实是对TypeScript中“重复元素类型的数组”定义理解有偏差，我来帮你梳理下正确的类型定义方式：

首先，你需要的是一个包含任意数量键值对的数组，每个键值对是[字符串类型的键, 字符串/数字类型的值]的元组结构。之前你写的[[string, string | number]]其实是“仅包含一个元组元素的二维数组”，所以传入多个元组时会触发类型错误。

正确的类型定义方式 #

有两种等价的写法，都能准确描述你需要的结构：

1. 拆分定义更清晰：

// 单个请求头的键值对元组
type HeaderItem = [string, string | number];
// 由多个HeaderItem组成的数组
type HeadersArray = HeaderItem[];

2. 简洁的合并写法：

type HeadersArray = [string, string | number][];

这两种写法都表示：数组里可以包含0个或多个符合[string, string | number]格式的元组，完全满足你批量传递自定义请求头的需求。

实际使用示例 #

把这个类型用到你的API调用函数里，就能实现类型校验了：

function sendApiRequest(headers: HeadersArray) {
  // 可以把数组转换成API需要的对象格式（可选）
  const headerObject = Object.fromEntries(headers);
  // 这里写发送请求的逻辑
}

// ✅ 符合类型要求的调用
sendApiRequest([['value1', 10], ['value2', 'test-string']]);

// ❌ 不符合类型要求的调用（会触发TypeScript报错）
sendApiRequest([['value3', true]]); // 布尔值不属于允许的value类型
sendApiRequest([[123, 'invalid-key']]); // 键必须是字符串类型

关于你之前尝试的递归类型 #

你写的type headerFormat = [[string, string | number], headerFormat[]]思路走偏了——它定义的是“第一个元素是元组，第二个元素是headerFormat数组”的嵌套结构，和你需要的“多个元组并列的数组”完全不符，所以自然无法生效。

备注：内容来源于stack exchange，提问作者Flauschi