在 TypeScript 中,数组(Array)和元组(Tuple)最大的区别是:数组通常只约束元素类型,而元组还可以约束元素的数量、顺序以及每个位置的类型。
你之前主要写 Go 后端,我们直接结合 Go 的数组、切片和结构体来理解。
一、先看数组(Array)
TypeScript 数组的写法:
1const numbers: number[] = [1, 2, 3]; 2 3const names: string[] = ["张三", "李四", "王五"]; 4
解释:
number[]:数组元素必须是数字。string[]:数组元素必须是字符串。- 数组长度可以动态变化。
例如:
1const numbers: number[] = [1, 2, 3]; 2 3numbers.push(4); // 正确 4numbers.push(5); // 正确 5numbers.push("6"); // 类型错误 6
这里 numbers 最终变成:
1[1, 2, 3, 4, 5] 2
你可以把 TypeScript 数组类比为 Go 的切片:
1numbers := []int{1, 2, 3} 2numbers = append(numbers, 4) 3
注意:TypeScript 的 Array 更接近 Go 的 slice,而不是 Go 的固定长度数组 [3]int。
二、再看元组(Tuple)
元组的写法:
1const user: [number, string] = [1001, "张三"]; 2
解释:
1[number, string] 2
规定了:
- 第一个元素必须是
number。 - 第二个元素必须是
string。 - 这个元组正常赋值时必须有两个元素。
例如:
1const user: [number, string] = [1001, "张三"]; // 正确 2 3const user2: [number, string] = ["张三", 1001]; // 错误:顺序不对 4 5const user3: [number, string] = [1001]; // 错误:缺少元素 6 7const user4: [number, string] = [1001, "张三", 18]; // 错误:元素过多 8
所以你可以理解成:
元组就是对数组中的每个位置都规定了类型的特殊数组。
三、数组和元组的直观对比
数组 Array
number[]
元素 1
10
number
元素 2
20
number
元素 3
30
number
元素 4
40
number
长度可变,元素类型相同
元组 Tuple
[number, string]
位置 0
1001
number
位置 1
张三
string
位置和类型都有约束
四、一个容易误解的地方:数组也能存不同类型
例如:
1const data: (number | string)[] = [1001, "张三", 18]; 2
这也是合法的数组。
那么和元组有什么区别?
1// 数组 2const data: (number | string)[] = [1001, "张三"]; 3 4// 元组 5const user: [number, string] = [1001, "张三"]; 6
对比:
1data[0] = "李四"; // 正确 2data[1] = 2002; // 正确 3 4user[0] = "李四"; // 类型错误 5user[1] = 2002; // 类型错误 6
原因:
- 数组
(number | string)[]:任意位置都可以是数字或者字符串。 - 元组
[number, string]:第一个位置必须是数字,第二个位置必须是字符串。
五、元组的典型应用:函数返回多个值
你写过 Go,应该比较熟悉多返回值:
1func getUser() (int64, string) { 2 return 1001, "张三" 3} 4 5func main() { 6 id, name := getUser() 7 fmt.Println(id, name) 8} 9
TypeScript 没有 Go 那样的原生多返回值机制,但可以通过元组实现类似效果:
1function getUser(): [number, string] { 2 return [1001, "张三"]; 3} 4 5const [id, name] = getUser(); 6 7console.log(id); // 1001 8console.log(name); // 张三 9
这里:
1const [id, name] = getUser(); 2
叫作数组解构赋值。
你可以理解为从元组中取出第一个和第二个元素,分别赋值给 id 和 name。
六、元组还有一些特殊用法
1. 可选元素
1let user: [number, string?]; 2 3user = [1001]; // 正确 4user = [1001, "张三"]; // 正确 5
string? 表示第二个元素可以不存在。
2. 带名称的元组
1type User = [id: number, name: string]; 2 3const user: User = [1001, "张三"]; 4
这里的 id 和 name 只是提高可读性的标签,并不会把元组变成对象。
访问方式仍然是:
1console.log(user[0]); // 1001 2console.log(user[1]); // 张三 3
3. readonly 元组
还有一个容易踩坑的地方:普通元组在运行时仍然是 JavaScript 数组。
例如:
1let user: [number, string] = [1001, "张三"]; 2 3user.push("李四"); // TypeScript 允许 4
因此,普通元组并不等于运行时不可改变的固定长度数组。
如果不希望通过 push 修改,可以使用:
1const user: readonly [number, string] = [1001, "张三"]; 2 3user.push("李四"); // 类型错误 4
readonly 是 TypeScript 的编译期约束,并不自动冻结运行时对象。
七、最后总结
| 对比 | 数组 Array | 元组 Tuple |
|---|---|---|
| 定义方式 | number[] | [number, string] |
| 元素类型 | 通常统一,也可以是联合类型 | 可以按位置指定不同类型 |
| 元素顺序 | 不限制各位置的具体类型 | 有类型顺序约束 |
| 长度 | 通常可变 | 类型层面可约束长度 |
| 使用场景 | 数据列表、批量记录 | 固定结构、函数多个返回值 |
| Go 类比 | []int 切片 | 类似固定结构的多返回值 |
实际开发建议:
- 一批任务 ID:使用
number[]。 - 一批用户名称:使用
string[]。 - 一个函数需要返回
[任务ID, 是否成功]:可以使用[number, boolean]。 - 一个用户包含很多字段:通常优先使用
interface或type定义对象,而不是使用很长的元组。
一句话记忆:数组关注“装什么类型的数据”,元组关注“每个位置应该放什么数据”。
参考文档
- Primers 编程伙伴/HTML/HTML 元素/data
- Primers 编程伙伴/Bash/帮助手册/id
- Primers 编程伙伴/Bash/帮助手册/readonly
- Primers 编程伙伴/Bash/帮助手册/type
《《Go 后端开发者学 TypeScript:数组和元组》》 是转载文章,点击查看原文。
