ReadonlyArray 与 ReadonlyMap
使用内置的 readonly 集合类型。
ReadonlyArray 与 ReadonlyMap 是 CoddyKit 上的免费 TypeScript Academy 课时。 这是第 3 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 4 节课。
只读集合类型
除了数组之外，TypeScript 还为内置集合提供了只读变体：ReadonlyArray<T>、ReadonlyMap<K, V> 和 ReadonlySet<T>。每种类型只公开其 API 中不会修改数据的部分。
const arr: ReadonlyArray<number> = [1, 2, 3];
console.log(arr.length, arr.includes(2));ReadonlyArray 回顾
ReadonlyArray<T> 支持迭代、索引访问以及 map 和 filter 等方法，但不支持 push、pop 或索引赋值。它是只读类型家族中的数组形式。
const tags: ReadonlyArray<string> = ['ts', 'js'];
console.log(tags.map((t) => t.toUpperCase()));
// tags.push('css'); // ErrorReadonlyMap
ReadonlyMap<K, V> 允许您查找、迭代和检查键，但移除了 set、delete 和 clear。从使用者的角度看，该映射的内容是固定的。
const ages: ReadonlyMap<string, number> = new Map([['Ada', 30], ['Sam', 25]]);
console.log(ages.get('Ada'), ages.has('Sam'));
// ages.set('Lee', 40); // Error从 ReadonlyMap 中读取
所有读取操作都会保留：get、has、size、keys、values、entries 和迭代。只有会修改数据的方法被移除了。
const m: ReadonlyMap<string, number> = new Map([['a', 1], ['b', 2]]);
for (const [k, v] of m) {
console.log(k, v);
}
console.log('size:', m.size);ReadonlySet
ReadonlySet<T> 支持成员检查和迭代，但移除了 add、delete 和 clear。对于固定的允许值集合，请使用它。
const allowed: ReadonlySet<string> = new Set(['read', 'write']);
console.log(allowed.has('read'), allowed.has('delete'));
// allowed.add('admin'); // Error迭代 ReadonlySet
您可以迭代 ReadonlySet 并读取其 size，但不能更改其中的内容。因此，它非常适合用于允许列表和权限集合。
const perms: ReadonlySet<string> = new Set(['view', 'edit']);
perms.forEach((p) => console.log('perm:', p));
console.log('count:', perms.size);向函数传递只读集合
对于只应读取数据的函数，请接受只读集合类型。这样既能表达意图，也能防止函数修改调用方拥有的数据。
function describe(set: ReadonlySet<string>): string {
return 'has ' + set.size + ' items';
}
const s = new Set(['x', 'y']);
console.log(describe(s));可变集合可以赋值给只读类型
普通的 Map 或 Set 可以赋值给对应的只读类型，因为这是缩小能力，而不是扩大能力。该函数只是放弃了修改数据的权限。
function keys(m: ReadonlyMap<string, number>): string[] {
return Array.from(m.keys());
}
const real = new Map([['a', 1]]);
console.log(keys(real));不可变集合 API
只读集合类型描述的是一个不可变的视图。底层对象在其他地方仍可能是可变的；只读类型只限制此引用能够执行的操作。
const backing = new Set<number>([1, 2]);
const view: ReadonlySet<number> = backing;
// view.add(3); // Error through the readonly view
backing.add(3); // but the original can still mutate
console.log(view.size);选择合适的只读类型
根据数据结构选择对应的只读类型：有序列表使用 ReadonlyArray，键值查找使用 ReadonlyMap，唯一成员集合使用 ReadonlySet。每种类型都会针对自身的结构强制执行不可变性。
const roles: ReadonlySet<string> = new Set(['admin', 'user']);
const limits: ReadonlyMap<string, number> = new Map([['admin', 100]]);
console.log(roles.has('user'), limits.get('admin'));更安全的共享状态
将内部集合以只读类型公开，可以防止调用方破坏模块的状态。他们可以自由查看数据，但只有您的代码能够修改数据。
class Registry {
private items = new Set<string>();
add(name: string): void { this.items.add(name); }
get all(): ReadonlySet<string> { return this.items; }
}
const r = new Registry();
r.add('a');
console.log(r.all.has('a'));快速检查
测试您对只读集合类型的理解。
回顾：只读集合
您学会了只读集合家族：
ReadonlyArray<T>、ReadonlyMap<K, V>和ReadonlySet<T>只公开读取操作。- 修改方法（
set、add、delete、push）会被移除。 - 可变集合可以赋值给对应的只读类型。
- 它们非常适合作为参数类型和返回类型，从而更安全地共享状态。
最后，我们将学习深层不可变模式。
function count(s: ReadonlySet<number>): number {
return s.size;
}
console.log(count(new Set([1, 2, 3])));常见问题解答
「ReadonlyArray 与 ReadonlyMap」课时是免费的吗？
是的 — 「ReadonlyArray 与 ReadonlyMap」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 4 节课。
「ReadonlyArray 与 ReadonlyMap」这节课中我会学到什么？
使用内置的 readonly 集合类型。 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 TypeScript Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 4 节。
「ReadonlyArray 与 ReadonlyMap」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 TypeScript Academy 课中编写并运行代码吗？
能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- readonly 属性
- readonly 数组与元组
- ReadonlyArray 与 ReadonlyMap
- 深度不可变模式