JavaScript / TypeScript / 系统课时

声明数组与只读数组

声明数组与只读数组

本课解决 TypeScript 中“集合里能放什么、是否允许修改”两个问题。你将掌握普通数组、泛型数组和只读数组的声明方式,并能根据函数职责选择可变或只读参数。

学习目标

  • 使用 T[] 与 Array<T> 限制数组元素类型
  • 使用 readonly T[] 与 ReadonlyArray<T> 阻止修改集合
  • 理解只读数组的赋值方向和浅只读边界

声明普通数组

数组类型写在元素类型之后。string[] 表示只能保存字符串,Array<string> 是等价的泛型写法。项目中通常优先使用简洁的 T[];遇到嵌套泛型或需要统一泛型风格时,可使用 Array<T>。

元素类型可以是联合类型,例如 (string | number)[] 允许字符串和数字共存。不要为了省事使用 any[],否则读写时都会失去类型检查。

声明只读数组

只读数组写作 readonly string[] 或 ReadonlyArray<string>。它允许读取、遍历、查找和创建新数组,但禁止 push、pop、索引赋值等原地修改。

当函数只负责读取集合时,应把参数声明为只读数组。这样既能接收普通数组,也能接收只读数组,并明确函数不会修改调用方数据。

完整示例

下面的示例同时演示普通数组、泛型数组、只读参数和通过复制生成新数组。保存为 array-demo.ts 后运行。

ts
const names: string[] = ["Ada", "Linus"];
const scores: Array<number> = [95, 88, 100];

names.push("Grace");
scores[0] = 98;

function formatItems(items: readonly string[]): string {
  // 只读取参数,不改变调用方的原数组
  return items.join(", ");
}

const readonlyNames: ReadonlyArray<string> = names;
const extendedNames = [...readonlyNames, "Margaret"];

console.log(formatItems(readonlyNames));
console.log(scores.reduce((sum, value) => sum + value, 0));
console.log(extendedNames.length);

运行命令:

bash
npx tsx array-demo.ts

预期输出:

text
Ada, Linus, Grace
286
4

实际文件路径和工具版本可能不同,但三行结果应与示例一致。

赋值方向与浅只读

普通数组可以赋给只读数组,因为这是减少修改权限;只读数组不能直接赋给普通数组,因为后者可能通过引用修改内容。将 readonlyNames 赋给 string[] 会产生类型错误。

只读数组只保护容器本身。如果元素是对象,仍可能修改对象属性。需要连属性一起保护时,可把元素声明为 Readonly<User>,例如 readonly Readonly<User>[]。

常见错误

const 不等于只读数组。const names = ["Ada"] 只禁止变量重新指向另一个数组,仍允许执行 names.push("Grace")。真正限制集合修改行为的是 readonly T[] 或 ReadonlyArray<T>。

本课总结

  • T[] 与 Array<T> 都能限制数组中的元素类型
  • 只读数组适合只读取、不修改集合的函数和共享数据
  • 数组只读是浅层约束,元素对象是否可变取决于元素类型

下一课预告

下一课将使用元组描述长度和位置都有含义的数据,并处理可选元素、剩余元素和只读元组。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

声明数组与只读数组

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通