TypeScript Academy · 课时

不可变构建器

Q: 「不可变构建器」这节课中我会学到什么？

返回新的构建器实例，实现更安全的组合。 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

返回新的构建器实例，实现更安全的组合。

不可变构建器 是 CoddyKit 上的免费 TypeScript Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 4 节课。

可变性与不可变性

前面的构建器会修改 this 并返回它。不可变构建器则会在每个步骤返回一个新的构建器实例，从不改变原实例。这会让组合更加安全。

共享修改带来的问题

如果代码中的两个部分持有同一个可变构建器，其中一个设置方法的调用就会同时影响两者。不可变构建器可以完全避免这种由别名引起的意外。

const base = makeMutableBuilder().url("/x");
// If base is shared, later .method() calls mutate everyone's copy.

返回新实例

不可变设置方法会复制当前状态，添加新字段，并构造一个全新的构建器。原实例不会受到影响。

class IB<S> {
  constructor(private readonly d: Record<string, unknown> = {}) {}
  with<K extends string, V>(k: K, v: V): IB<S & Record<K, V>> {
    return new IB<S & Record<K, V>>({ ...this.d, [k]: v });
  }
}

通过展开实现结构共享

展开表达式 { ...this.d, [k]: v } 会复制现有条目并覆盖一个键。未改变的值会按引用共享，因此复制成本很低。

const a = new IB<{}>().with("url", "/x");
const c = a.with("method", "GET");
// a still only has url; c has url and method.

原实例永不改变

由于每个步骤都会生成一个新对象，因此从较早的构建器分支出来是安全的。您可以在多个地方重复使用一个部分构建的 base。

const base = new IB<{}>().with("url", "/api");
const get = base.with("method", "GET");
const post = base.with("method", "POST");
console.log("base untouched; get and post diverge");

只读内部状态

将内部数据标记为 readonly 可以说明这种意图，并阻止类内部意外地直接写入数据。继续操作的唯一方式是创建一个新实例。

class IB<S> {
  constructor(private readonly d: Readonly<Record<string, unknown>> = {}) {}
}

类型化的不可变构建

状态参数仍会贯穿整个过程，因此我们现在可以在不可变基础上，像之前一样精确地限制 build()。

interface Out { url: string; method: string }
class IB<S> {
  constructor(private readonly d: Record<string, unknown> = {}) {}
  with<K extends string, V>(k: K, v: V): IB<S & Record<K, V>> {
    return new IB<S & Record<K, V>>({ ...this.d, [k]: v });
  }
  build(this: IB<{ url: string; method: string }>): Out { return this.d as Out; }
}
const out = new IB<{}>().with("url", "/u").with("method", "GET").build();
console.log(out.url);

更安全的组合

不可变构建器可以像值一样进行组合：传递一个构建器，派生出新的构建器，而不必担心下游调用会改写共享状态。这正是不可变数据在任何地方带来的好处。

可复用预设

您可以保存一个常用的起始点，然后从它分支出许多构建器。得益于写时复制的设置方法，每个分支都是彼此独立的。

const jsonBase = new IB<{}>().with("header", "application/json");
const usersReq = jsonBase.with("url", "/users");
const ordersReq = jsonBase.with("url", "/orders");
console.log("two independent requests from one base");

成本考量

每个步骤都会分配一个新对象。对于典型的配置构建来说，这点成本可以忽略不计，而结构共享也能让复制保持浅层。只有极其频繁的循环才可能察觉到它。

可变与不可变总结

可变构建器略快且更简单；不可变构建器更适合共享，也更容易推理。当构建器会被传递使用或作为预设重复使用时，优先选择不可变构建器。

快速检查

快速检查本课内容。

回顾

不可变构建器通过 { ...this.d, [k]: v } 实现结构共享，每个步骤返回一个新实例，从不修改 this。原实例保持不变，因此可以安全地进行组合并复用预设，代价只是少量的对象分配。

常见问题解答

「不可变构建器」课时是免费的吗？

是的 — 「不可变构建器」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 4 节课。

「不可变构建器」这节课中我会学到什么？

返回新的构建器实例，实现更安全的组合。你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「不可变构建器」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 TypeScript Academy 课中编写并运行代码吗？

能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 TypeScript Academy