费尔德曼倡导通过类型重构与不透明封装彻底根除前端非法状态

"Making Impossible States Impossible" by Richard Feldman — elm-conf

elm-conf

应用状态的隐性缺陷源于松散的数据建模,开发者应以领域联合类型与不透明类型取代双重Maybe和并行列表,在编译期杜绝非法状态并规避重构破坏。

AI-assisted summary of "Making Impossible States Impossible" by Richard Feldman — original source. Check the original for full context.

Source published:

Key ideas

  • Richard Feldman 提出“让不可能的状态变得不可能”的核心理念,倡导通过强类型系统在编译阶段杜绝非法数据组合,而非依赖运行时的校验与重排逻辑。 (0:10)
  • 在设计数据模型时,应避免使用多个并行的 Maybe 或并行的 List;通过定义专属联合类型或将字段封装进单条记录,可彻底杜绝数据不对齐与非法状态。 (9:02)
  • 借助 Zipper List 能够优雅建模非空导航状态,从类型层面同时保证“至少存在一项”以及“当前激活项必定在列表内”。 (14:14)
  • 对外暴露 API 时应优先使用单构造器联合类型构建不透明类型(opaque types),隐藏底层数据结构以在重构时不引入任何破坏性变更(breaking change)。 (17:28)

Detailed notes

## Background 该视频由频道 elm-conf 于 2016 年 9 月 19 日在 YouTube 平台上发布,主讲人为 Richard Feldman。根据页面介绍,排查最耗时的 Bug 往往源于应用陷入了“本不该可能发生”的状态;本场演讲深入探讨了如何利用正确的建模技巧与 Elm 编译器,从根本上杜绝这些非法状态。

## TL;DR Richard Feldman 围绕“让不可能的状态变得不可能”这一核心理念,分享了如何在类型系统中设计健壮的数据模型。他以 elm-css 库规避 CSS 语法冲突以及问卷调查应用的迭代为例,演示了如何通过拆分强类型字段、利用非空列表与 Zipper List 杜绝逻辑缺陷。随后,他展示了通过单构造器联合类型构建不透明类型(opaque types)以隐藏内部实现,并在增添撤销功能时用领域专属联合类型替代多重 Maybe。最后,他提炼出一套自省准则,指导开发者在面对并行列表、多重可空状态与模块封装时作出更稳健的架构决策。

## Atmosphere & style 整场演讲氛围轻松随和且充满极客式的幽默感,开场致敬主办方并穿插可爱的卷饼猫梗图,让技术探讨毫无沉闷感。Richard 的叙述条理清晰、抽丝剥茧,以平易近人的口吻将复杂的函数式数据结构与实际业务痛点融会贯通。聆听过程就像在与一位经验丰富的技术伙伴促膝长谈,没有浮夸的实时演示,却能带给听众一种豁然开朗、由衷点头的实用启发感。

## Bulletin - [00:10](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=10s) Richard Feldman 提出“让不可能的状态变得不可能”的核心理念,倡导通过强类型系统在编译阶段杜绝非法数据组合,而非依赖运行时的校验与重排逻辑。 - [09:02](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=542s) 在设计数据模型时,应避免使用多个并行的 Maybe 或并行的 List;通过定义专属联合类型或将字段封装进单条记录,可彻底杜绝数据不对齐与非法状态。 - [14:14](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=854s) 借助 Zipper List 能够优雅建模非空导航状态,从类型层面同时保证“至少存在一项”以及“当前激活项必定在列表内”。 - [17:28](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1048s) 对外暴露 API 时应优先使用单构造器联合类型构建不透明类型(opaque types),隐藏底层数据结构以在重构时不引入任何破坏性变更(breaking change)。

## Key takeaways - [00:10](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=10s) 许多耗费大量时间的 Bug 根源在于应用进入了“本不该可能发生”的状态,通过合理的模型设计可以在编译期彻底消灭它们。 - [04:02](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=242s) 在 elm-css 最初的设计中,所有样式声明被塞入同一个平铺列表中,导致用户可以随意破坏 CSS 规范中关于 @rule 的严格先后顺序。 - [05:50](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=350s) 与其编写繁琐的重排代码与测试用例去纠正非法输入,不如直接拆分数据结构,使非法样式表在语法层面无法被表达出来。 - [05:50](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=350s) “测试固然好,但让错误变得不可能发生更胜一筹”:若非法的测试用例连编译都无法通过,长期的维护负担将大幅减轻。 - [09:02](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=542s) 问卷应用中若将提示列表与回答列表分开存储,可能引发回答数量与题目数量脱节的神秘状态,应将二者绑定在单条记录中。 - [11:21](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=681s) 利用“首元素(first)配合其余元素列表(others)”的模式,可在类型系统层面强行约束列表非空,避免空题库的非法状态。 - [14:14](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=854s) 单纯引入 current 字段会导致当前题目可能不在列表中;引入 Zipper List(拉链列表)将结构拆分为 previous、current 与 remaining,可确保当前项天然属于列表且非空。 - [15:51](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=951s) 直接暴露底层记录结构会导致重构数据模型时破坏外部调用的兼容性,造成严重的破坏性变更(breaking change)。 - [17:28](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1048s) 使用单构造器联合类型替代类型别名,并在模块导出时隐藏构造器,可将数据类型变为不透明类型(opaque type),对外部调用方彻底隐藏内部布局。 - [17:28](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1048s) 通过模块暴露的辅助函数(如 questions、currentQuestion)向外部平铺输出数据,既能保障内部状态不可能出错,又为调用方提供了最简便的 API。 - [21:25](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1285s) 在状态栏与撤销场景中,并列使用两个 Maybe 字段容易陷入“未展示状态栏却挂起恢复数据”的矛盾状态,应使用专用的联合类型替代。 - [23:38](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1418s) 排查自省准则一:当想要添加第二个 Maybe 时,应优先考虑切换为一个承载不同业务分支的领域联合类型。 - [23:38](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1418s) 排查自省准则二:当想要添加第二个独立列表时,应优先考虑将元数据富化到单个列表的元素记录中。 - [23:38](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1418s) 排查自省准则三:从首个版本开始就要隐藏实现细节并构建不透明类型,避免调用方产生依赖,从而为未来重构保留无痛迭代的空间。

## Detailed walkthrough ### [00:10](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=10s) 开场致谢与演讲主旨

在正式演讲开始前,Richard Feldman 提议全场起立鼓掌,向 elm-conf 的组织者们致敬。他感叹道,虽然这是组织团队第一次办大会,但全天演讲的精彩程度令人震撼;自己听完一场就祈祷“幸好我不用接着那场讲”,直到 Murphy 的分享作为最后的希望也同样惊艳全场。作为当天的压轴演讲,Richard 表示这场分享会更轻松(chill)、没有酷炫的实时 Demo,但希望能带给大家切实可行的收获。正如他在开场时所强调的:“Hopefully though this is going to be something practical something where you can walk away with less of a whoo and more of a so that's what we're going for here making impossible States impossible.”(希望这能带来一些实用的东西,让大家离场时不是发出‘哇’的惊叹,而是若有所思地点头——这就是我们的目标:让不可能的状态变得不可能)。

[01:17](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=77s) Elm CSS 与 CSS 规范的冷门规则

为了证明自己是个“讲道理、通情达理的人”,Richard 幽默地拿自己编写 CSS 预处理器来开刀,引出了他开发的库——elm-css。elm-css 的核心思路是用 Elm 代码生成 CSS 文件或内联样式(inline styles),语法结构尽量贴近原生 CSS,例如用函数调用来表示选择器与声明。该库最核心的设计目标之一是**仅生成合法的样式表(valid stylesheets)**,只要无法生成合规 CSS,就应当在编译期或验证阶段直接报错。

深入研究 CSS 规范后,Richard 发现让样式表变得非法的场景极多,其中最令他惊讶的是关于 `@rule`(如 `@media`、`@font-face` 等)中三个冷门规则的严格限制:

- **`@charset`**:必须是整个样式表的绝对首字符。哪怕在它前面只有一个换行符,整个样式表都会直接失效(invalid);且全表严禁重复定义。 - **`@import`**:必须置于 `@namespace` 和常规样式声明(style declarations)之前;由于 `@charset` 必须在第一位,因此它只能紧随 `@charset` 之后。 - **`@namespace`**:必须在 `@import` 之后、常规样式声明之前声明。

这些规则意味着合规样式表必须严格按照“单个 `@charset` -> 多个 `@import` -> 多个 `@namespace` -> 常规样式”的分组顺序连续排列。

[04:02](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=242s) 初版 API 的设计陷阱与排序方案

在最初移植到 elm-css 时,Richard 凭直觉希望保留手写 CSS 的体验,将它们都设计成扁平的列表项:直接提供 `charset`、`import_`(因为 `import` 是 Elm 保留关键字而加下划线)、`namespace` 以及常规选择器函数。然而,一旦放在同一个列表 `List Declaration` 中,就意味着它们的底层类型完全相同。

这种统一类型的设计带来了严重的隐患:用户可以在列表中任意打乱顺序,比如把普通样式写在最前、在 `namespace` 与 `import` 之间反复交替,甚至在文末连写两个 `charset`。由于类型系统不加干预,这行代码能顺利编译,但若天真地直接输出为 CSS,就会违背前述所有规则。面对这个缺陷,Richard 最初构思的解决方案是**“校验与自动重排”(Validate and Sort)**: 1. **校验阶段**:若用户声明了多个 `charset`,则在验证步骤抛出错误阻止。 2. **重排阶段**:代码生成时自动纠错,强制按照规范顺序依次吐出 `charset`、`import`、`namespace` 和样式。

但这种方案意味着必须编写大量繁重的测试用例,覆盖交替穿插、重复定义等各种非法排列组合。

[05:50](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=350s) 架构重构:用类型消除非法状态

Richard 随后向同事 Evan Czaplicki(Elm 创始人)请教 API 设计。Evan 提供了一个截然不同的视角:“如果你直接让非法样式表根本无法被表达出来呢?如果数据模型本身就无法容纳非法的样式表呢?”

Richard 意识到,自己之前将所有项塞进一个声明列表,只是在盲目模仿 CSS 的外在形式。既然规范要求它们具有严格的分块结构与数量限制,为什么还要赋予它们相同的类型?赋予它们相同类型反倒成了一种“反特性”(antifeature)。团队最终将数据模型重构为分离的字段:

```mermaid flowchart TD accTitle: elm-css Stylesheet Data Model accDescr: Schema showing how stylesheet properties are split into strictly typed distinct fields to prevent invalid ordering.

subgraph Stylesheet["Stylesheet Record"] CS["charset: Maybe String<br/>(最多只允许一个)"] IM["imports: List Import<br/>(独立类型列表)"] NS["namespaces: List Namespace<br/>(独立类型列表)"] DC["declarations: List Style<br/>(纯常规样式声明)"] end

CS --> IM IM --> NS NS --> DC ```

这种数据模型带来了立竿见影的收益: - `@charset` 变为 `Maybe String`,自然限制为 0 个或 1 个,彻底杜绝多重定义。 - `import`、`namespace` 和样式声明各自拥有完全不兼容的独立类型,使用者根本无法写出交替穿插的代码,否则连编译都无法通过。 - 生成合法样式表变得极其直观:只需检查 `charset` 是否存在,再顺次输出列表即可。

对于这种架构带来的测试与设计转变,Richard 总结道:“Tests are good, but impossible is better.”(测试固然好,但让错误变得不可能发生则更胜一筹)。如果连针对非法状态的测试代码都因无法通过编译而写不出来,维护负担自然大幅减轻。此外,更严谨的数据模型也会反哺出更清晰的 API,强行引导调用方采用正确的方式组织数据。随后,Richard 将这一思想进一步引申到通用的前端业务开发中:如果不写底层库,普通的应用程序又该如何通过模型设计让非法状态彻底消失?他随即准备以一个具体的问卷调查(survey app)案例展开讲解。

[09:02](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=542s) 问卷应用的数据建模:将提示与回答耦合

Richard Feldman 引入了一个具体的案例:一个在线调查问卷应用。该应用的基本形态非常简单,页面上依次呈现一系列问题提示(prompts),例如“elm-conf 上最棒的部分是什么?”,并在每个提示下方提供一个文本框供用户输入回答(responses)。应用不断向用户提问,并通过输入框收集文本数据。

一种最直观的建模方式是将它们分别存为两个独立的列表:一个是提示列表 `prompts: List String`,另一个是回答列表 `responses: List (Maybe String)`。回答之所以用 `Maybe String` 表示,是因为用户可能尚未作答,状态为 `Nothing`;随着答题进行,逐步转变为 `Just "..."`。在正常的示例中,提示包括“你最喜欢的 elm-conf 回忆是什么?”、“这是真实的生活吗?”、“抑或只是幻觉?(引用波西米亚狂想曲歌词)”。对应的回答列表可能是第一题填入“所有的跳水观众(crowd surfers)!他们太棒了”,后面两道题由于未答则均为 `Nothing`。

然而,这种双列表设计隐藏着一个严重的设计缺陷:系统很容易陷入一种完全非法的状态——例如提示列表为空(`[]`),回答列表中却凭空出现了一个 `Just "Yes"`。这种状态在业务逻辑上是毫无道理的;一旦在运行时出现,说明业务逻辑在某处发生了诡异的崩溃。Richard 强调,与其在运行时遇到这种神秘状态后再去层层回溯调试代码,不如在编译期就让这种状态根本无法构建。解决方案非常直接:将提示与回答紧密绑定在同一个结构中,定义一个包含 `prompt` 和 `response` 的记录(Record),再维护该记录的列表。这样一来,任何提示必然附带一个回答槽位,任何回答也绝不可能脱离提示而独立存在。

> “如果这本该是不可能的,我们为什么要允许它?为什么要允许这种不可能的状态发生?” —— Richard Feldman

[11:21](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=681s) 问题导航需求与非空列表建模

当问卷应用新增“导航(navigation)”功能时,设计变得更为复杂。用户不再必须按顺序作答,而是能够点击“上一题”和“下一题”,跳过难题稍后再答,或者返回修改先前的答案。为了专注于导航逻辑,模型中抽离出了导航历史(`History`)。

初步的建模方案是保留一个问题列表 `questions: List Question`,并增加一个当前正在作答的问题字段 `current: Question`。例如在关于糕点的问卷中,列表中包含关于蛋糕(cake)、派(pie)和饼干(cookies)的问题,而 `current` 指向“派”,表示用户当前停留在中间这道题上。但这种建模同样允许不可能的状态发生:`questions` 列表为空(`[]`),而 `current` 却依然显示用户正在回答关于“派”的问题。一个没有任何题目的问卷是毫无意义的,只要用户能够与之交互,系统中就必须至少存在一道题。

为了在类型系统层面强制保证“至少有一道题”,Richard 提出了利用类似列表模式匹配(pattern match)的拆分方式:用独立的 `first: Question` 字段表示首个元素,再用 `others: List Question` 包含后续的其余问题。从概念上看,将 `first` 与 `others` 进行拼接(cons)即可还原出完整的序列,但在类型约束上,它从根源上杜绝了题库为空的情况——无论如何,`first` 总是必须存在的。

```mermaid flowchart LR accTitle: 从普通列表演变为非空列表结构 accDescr: 对比 questions List Question 产生空列表缺陷,与 first 搭配 others 确保至少一题的结构差异。

subgraph Flawed["脆弱设计 (允许 0 题)"] direction TB F_List["questions: List Question (可能为空 [])"] F_Curr["current: Question (派)"] F_List -.->|"脱节"| F_Curr end

subgraph NonEmpty["强约束设计 (至少 1 题)"] direction TB N_First["first: Question (必须存在: 蛋糕)"] N_Others["others: List Question (后续题目: 派, 饼干)"] N_First --> N_Others end ```

[14:14](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=854s) 引入 Zipper 列表杜绝脱靶问题

即使利用 `first` 和 `others` 消除了空列表的可能性,上述模型依然存在另一个严重的漏洞:`current` 所指向的问题,可能根本不在问卷的题目序列中。比如,第一题是蛋糕,其余题目是派和饼干,但 `current` 却被赋值为“冰淇淋(ice cream)”。用户在界面上回答了一个完全不存在的问题,提交之后系统必然产生不可预料的行为。

为了解决这个问题,Richard 借鉴 Tessa Kelly 在数据结构方面的思路,引入了名为 **Zipper List**(拉链列表)的数据结构。Zipper 的核心思想是将列表沿着“当前聚焦项”拆分为三个独立部分: 1. `previous: List Question`:记录当前位置之前的所有问题; 2. `current: Question`:当前正在查看或作答的单一问题; 3. `remaining: List Question`:当前位置之后的所有剩余问题。

```mermaid flowchart TD accTitle: Zipper List 数据结构示意 accDescr: 展示 previous、current 和 remaining 三部分如何拼装为完整的题目列表,且 current 永远包含在列表内。

subgraph Zipper["Zipper List 状态表示"] direction LR P["previous\n[1: 蛋糕, 2: 派]"] C["current\n[3: 饼干]"] R["remaining\n[4: 冰淇淋]"] P === C === R end

Full["完整列表拼接结果: [蛋糕, 派, 饼干, 冰淇淋]"] Zipper --> Full ```

在 Zipper 结构下,如果题目序列为蛋糕、派、饼干、冰淇淋,而当前停留在饼干,则 `previous` 为 `[蛋糕, 派]`,`current` 为 `饼干`,`remaining` 为 `[冰淇淋]`。要获取全部题目,只需将三者按顺序合并。这种设计带来了两项绝对的类型保证: - “当前问题不在问题列表中”变为不可能:因为当前问题本身就是该数据结构的核心锚点,完整列表必然由它参与构成。 - “题库为空”同样不可能:即使处于最极限的空状态,`previous` 和 `remaining` 都为空列表,也必定会留存一个 `current`。不可能的状态被彻底消除。

> “在最糟糕的情况下,即使这里空到了极点,也就是 previous 没有任何内容,remaining 没有任何内容,我们依然拥有 current。” —— Richard Feldman

[15:51](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=951s) 数据结构重构引发的破坏性变更

在完善了底层模型后,Richard 话题一转,打趣地切入所谓的“升级体验”——幻灯片上放了一张被卷成墨西哥卷饼(Burrito)模样的猫咪图片,他随即笑着澄清这跟卷饼没有任何深奥的技术关联,纯粹是因为自己喜欢猫咪图片。

回归正题,导航模块的核心 API 通常需要暴露以下几个基础操作: - `History` 记录类型:供外部读取数据并渲染当前界面; - `back: History -> History`:将当前问题后退一步; - `forward: History -> History`:将当前问题前进一步; - `answer: Answer -> History -> History`:记录用户的作答,将内部的 `Nothing` 更新为 `Just`; - `init: Question -> List Question -> History`:传入首题与后续题目,初始化生成一个 `History` 实例。

然而,重构带来了新的架构难题。为了让内部表示更加健壮,底层的 Record 结构从原本包含 `questions` 字段改为了 `previous` 与 `remaining` 的 Zipper 形式。如果外部使用该模块的代码直接通过字段访问语法读取了 `history.questions`,那么这次内部优化就变成了一次致命的破坏性变更(breaking change),会导致现有的上层调用代码在编译时全线报错,因为 `questions` 字段已经不复存在了。这引出了如何在增强内部模型健壮性的同时,保持公开 API 稳定与平滑过渡的思考。

> “当我们在内部升级了表现形式、使其变得更加健壮的同时,在这个过程中我们实际上改变了记录的结构。” —— Richard Feldman

[17:28](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1048s) 使用单构造器联合类型与不透明类型隐藏实现细节

理查德·费尔德曼(Richard Feldman)指出,我们在底层重构数据结构(例如从普通列表重构成 ZipList)完全是为了让内部状态更健壮,这本不应该演变成破坏性的重大变更(breaking change)。“所以,我们能不能做到让‘依赖特定实现细节’这件事变得不可能?我们能不能让任何使用我们 API 的人在我们升级库时不担心代码被破坏?是的,我们完全做得到。”解决这个问题的关键手法就是:用单构造器联合类型(single Constructor Union type)替代类型别名(type alias)。

在代码层面,原本的 `type alias History =...` 被改为 `type History = History { previous:..., current:..., remaining:... }`。这种包装虽然让内部解构数据多了一步操作——比如在写 `back` 函数时需要用 `case history of History { previous, current, remaining } ->...` 来模式匹配——但 Elm 支持在函数参数中直接解构单构造器联合类型,形如 `back (History { previous, current, remaining }) =...`,既简洁又安全。更核心的步骤在于模块的暴露控制(exposing):通常定义联合类型时会习惯性地写 `History(..)` 将类型及其构造器全盘暴露;但如果只写 `History` 而省略构造器 `(..)`,外部模块就只能在类型注解中使用该类型,完全无法对它进行模式匹配或直接访问内部字段,从而将 `History` 变成了不透明类型(opaque type)。

```mermaid flowchart TD accTitle: 模块封装与不透明类型架构 accDescr: 内部模块封装真实数据结构,仅对外暴露安全函数和类型签名

subgraph ModuleInternal["模块内部 (Internal Implementation)"] A["ZipList 数据结构<br/>(previous, current, remaining)"] --> B["单构造器包装<br/>type History = History {...}"] end

subgraph ExposingControl["暴露控制 (Module Boundary)"] B --> C["仅暴露类型: History<br/>隐藏构造器 History(..)"] B --> D["暴露辅助 API:<br/>questions, currentQuestion"] end

subgraph ExternalConsumers["外部调用方 (API Consumers)"] C --> E["类型安全: 可用作类型注解"] D --> F["通过受控函数读取平铺数据<br/>无感知底层演进"] end ```

- 将外部代码与内部数据布局完全解耦后,外部若想获取问卷列表,不再使用字段访问 `history.questions`,而是调用模块暴露的专用函数,如 `questions: History -> List Question` 与 `currentQuestion: History -> Question`。 - 外部消费者通常只想获取一个简单的列表去渲染界面或导航链接,直接处理 ZipList 反而是负担;隐藏 ZipList 既保证了内部状态不可能出错,又为调用者提供了最简单舒适的 API。 - 升级内部实现时不再产生任何破坏性变更,用户完全不必感知底层的重大改造。

---

[21:25](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1285s) 状态栏与撤销逻辑:用领域专用联合类型替代双重 Maybe

接着,费尔德曼给应用增加了一个状态栏(status bar)需求:当用户编辑问卷时,顶部需要弹出一个黄色的提示条显示“问卷已创建(question created)”,旁边配个小喇叭图标。最直接的建模方式是引入一个 `status: Maybe String`,为 `Nothing` 时不显示,为 `Just "..."` 时显示对应文本。然而,现代应用往往还支持“问卷已删除(question deleted)”以及配套的“撤销(Undo)”按钮;为了实现点击撤销就能还原问卷的功能,应用必须暂存刚刚被删掉的那道题。

一种直觉的扩展思路是再加一个字段:`questionToRestore: Maybe Question`。此时状态组合便埋下了隐患:创建问题时是 `status = Just "..."` 搭配 `questionToRestore = Nothing`;删除问题时二者皆为 `Just`;可一旦代码出现疏漏,产生了 `status = Nothing` 却伴随 `questionToRestore = Just question` 的状态,系统的行为就会变得极其荒谬——既没有显示提示条,后台却悬挂着可还原的数据。费尔德曼直言:“这看起来又是某个地方出错了,我们的逻辑里出现了 bug……这本应该是不可能的。”

解决这一矛盾的做法是用一个贴合领域业务的专属联合类型取代两个独立的 `Maybe`,彻底消灭非法组合:

| 状态分支 (Constructor) | 携带数据 (Payload) | 对应业务含义 | |:--- |:--- |:--- | | `NoStatus` | 无 | 无任何提示信息展示 | | `TextStatus` | `String` | 普通提示消息(如问卷创建成功) | | `DeletedStatus` | `String`, `Question` | 包含删除提示文字与待撤销恢复的问卷对象 |

---

[23:38](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1418s) 总结与核心原则:三项排查自省清单

在演讲尾声,费尔德曼回顾并提炼了在 Elm 中消除非法状态的三个关键决策考量:

第一,是使用两个 `Maybe`,还是定制一个专属联合类型?费尔德曼结合自身经验谈到:“很多时候我从一个 `Maybe` 起步,感觉一切都挺好;尤其是有 JavaScript 背景的人,直觉往往就是顺手再往里塞一个 `Maybe`。但经常只要我多花一秒钟想想,就会发现:‘啊,其实这两个 `Maybe` 组合起来,肯定会出现我不想要的情况。’从一个 `Maybe` 直接切换成联合类型,往往远好于再追加第二个 `Maybe`。随着应用规模越来越大,这一点就越发正确。”

第二,是使用两个独立的列表,还是使用一个“每个元素包含两个字段”的列表?当开发者想在模型中引入第二个并行列表时,务必停下来审视数据归属,优先考虑将元数据直接富化到现有列表中,从根源上杜绝长度失配或索引不对齐的同步难题。

第三,我们能否在不破坏用户构建的前提下重构内部实现?费尔德曼告诫大家,这必须在一开始就有所规划,“一旦你把实现细节暴露出去,别人依赖上了,到那时想避免破坏性更新就已经太晚了。”因此,在首个版本中就默认隐藏实现、利用单构造器联合类型构建不透明类型,是维持长期 API 稳定的不二法门。最后,他总结呼吁:“如果代码中可能表示出那些本应不可能存在的状态,请务必考虑把这些‘可能’变成‘不可能’。”

## Notable quotes > [23:38](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1418s) 如果代码中可能表示出那些本应不可能存在的状态,请务必考虑把这些‘可能’变成‘不可能’。 — Richard Feldman

> [23:38](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1418s) 从一个 Maybe 直接切换成联合类型,往往远好于再追加第二个 Maybe。随着应用规模越来越大,这一点就越发正确。 — Richard Feldman

> [23:38](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1418s) 一旦你把实现细节暴露出去,别人依赖上了,到那时想避免破坏性更新就已经太晚了。 — Richard Feldman

## Mentioned Richard Feldman, Evan Czaplicki, Tessa Kelly, elm-css, Elm, CSS, elm-conf, Murphy

## Video description Among the most time-consuming bugs to track down are the ones where we look at our application state and say "this shouldn’t be possible."

We can use Elm’s compiler to rule out many of these bugs in the first place—but only if we design our Models using the right techniques! This talk explores how.

[Source](https://www.youtube.com/watch?v=IcgmSRJHu_8)

中文简报

Feldman重构Elm数据模型以消除非法状态并减少测试 利用自定义类型和不透明结构对应用状态建模,可在编译期消除非法排列,无需运行时防御性校验,同时保护公共API免受破坏性重构影响。 结合构建elm-css库的经验,Richard Feldman阐述了如何围绕领域约束设计数据结构,从而免去防御性验证与重新排序逻辑。他以问卷调查界面为例,在应用代码中演示了这一理念,展示了如何将相互依赖的提示和响应字段进行耦合、构建确保非空的列表,以及使用拉链(zipper)数据结构安全表示当前选中项。Feldman进一步解释了不透明类型与访问器函数如何在内部重构期间防止下游使用者遭遇破坏性变更。最后,他总结了实用的设计启发式方法,例如使用领域特定的自定义类型来替换多个Maybe值的组合或并行列表。 开发者应当设计出在编译期就无法表示无效配置的类型,而不是依赖防御性验证流水线和排序逻辑在运行时捕获非法状态。 (4:00) 维护并行集合或多个独立的Maybe字段往往会导致不同步的逻辑错误,而将数据耦合到单个强化记录或自定义联合类型中即可消除这些问题。 (9:02) 在顺序导航中使用拉链数据结构能够确保集合非空,并通过在结构上将当前焦点项嵌入在先前元素与剩余元素之间,防止出现脱钩的活动状态。 (14:14) 将模块构造函数隐藏在稳定访问器函数之后的不透明类型,可防止下游使用者与内部记录结构产生耦合,从而允许进行破坏性数据模型重构而不影响使用者。 (17:28)

精炼阅读摘要

Richard Feldman在elm-conf演讲中主张,软件开发应通过精确的类型系统设计,使非法或无意义的应用状态在编译期就无法表达,从而消除隐性业务缺陷并大幅减少防御性测试。 告别验证与排序陷阱:以类型约束规范 (1:17) 在为Elm开发CSS预处理器elm-css时,开发者需要满足CSS规范中极其严格的规则:@charset必须位于样式表首字符且最多出现一次,后续必须依次为@import、@namespace和常规样式声明。Feldman最初将所有规则归入同质列表List Declaration,导致用户可以随意调换顺序或重复声明;他原本计划编写复杂的防御性验证管道与自动排序算法,并配以庞大的测试套件。然而Elm创建者Evan Czaplicki建议直接让非法样式表变得无法表示。 Feldman据此重构了数据模型,彻底摒弃扁平列表。新方案将字符集建模为Maybe String以确保最多只有一个,导入规则设为独立列表List Import,命名空间设为List Namespace,普通样式设为List Declaration。序列化器仅需按固定顺序逐项输出即可天然保证合法性。Feldman指出,虽然编写测试很有必要,但在类型层面直接使错误状态成为不可能显然更加可靠。 防止数据脱节:耦合记录与拉链列表 (9:02) 在设计问卷调查界面时,若将题目列表与可选答案列表拆分为各自独立的集合,极易出现题目列表为空但答案列表却存有数据的矛盾状态。解决这一缺陷的方法是将提示文本与用户响应绑定到同一个Question记录中,再维护这些记录的集合,确保二者生命周期完全一致。 进一步支持前后题目导航时,若使用独立字段记录当前题目,可能导致当前激活的问题根本不存在于问卷中。Feldman引入了拉链列表(Zipper List)数据结构,将导航状态分为previous、current和remaining三部分。这种结构不仅在类型层面强制保证了问卷至少存在一道当前问题,同时将激活项物理内嵌于题目序列中,彻底杜绝了当前指针与底层数据脱节的异常状态。 利用不透明类型封装隐藏内部实现 (17:28) 为了消除非法状态而将内部数据结构由普通列表重构为拉链列表时,极易直接破坏外部依赖原有字段的代码。Feldman提出,应当利用Elm的单构造函数自定义类型来构建不透明类型(Opaque Types),并在模块导出时不暴露其构造函数,以此实现严格封装。 当外部调用方无法直接解构或访问内部字段时,模块可以通过导出稳定的访问器函数(如返回题目完整列表的函数)来满足视图渲染需求。这种做法将公共接口与底层存储机制解耦,使得维护者在未来重构数据模型以防御非法状态时,下游调用方完全不受影响,避免了破坏性变更。 消除多Maybe组合:状态条互斥建模 (21:25) 在问卷编辑器的状态栏场景中,界面需要展示普通提示信息,并在删除题目时提供撤销操作。若分别用两个独立的Maybe字段保存状态文本和待恢复题目,就会出现有待恢复数据却缺乏状态文本(导致无法展示撤销按钮)的逻辑盲区。 Feldman强调,遇到类似关联状态时,应避免盲目累加Maybe,改用领域专用的联合类型。通过定义包含NoStatus、TextStatus以及携带待恢复题目的DeletedStatus三种分支的自定义类型,编译器就能强制保证撤销题目必须伴随提示文本存在,而空闲状态下绝不会残留遗留数据。 Feldman总结了三条核心设计经验:面对多项可选数据时,优先使用联合类型而非并列多个Maybe;避免维护易产生不同步问题的独立双列表;在设计模块时默认隐藏类型构造函数并提供稳定访问器。通过类型驱动设计消灭非法状态,能够以更低的维护成本构建出更健壮的应用程序。

Detailed notes — zh

## Background 该视频由频道 elm-conf 于 2016 年 9 月 19 日在 YouTube 平台上发布,主讲人为 Richard Feldman。根据页面介绍,排查最耗时的 Bug 往往源于应用陷入了“本不该可能发生”的状态;本场演讲深入探讨了如何利用正确的建模技巧与 Elm 编译器,从根本上杜绝这些非法状态。 ## TL;DR Richard Feldman 围绕“让不可能的状态变得不可能”这一核心理念,分享了如何在类型系统中设计健壮的数据模型。他以 elm-css 库规避 CSS 语法冲突以及问卷调查应用的迭代为例,演示了如何通过拆分强类型字段、利用非空列表与 Zipper List 杜绝逻辑缺陷。随后,他展示了通过单构造器联合类型构建不透明类型(opaque types)以隐藏内部实现,并在增添撤销功能时用领域专属联合类型替代多重 Maybe。最后,他提炼出一套自省准则,指导开发者在面对并行列表、多重可空状态与模块封装时作出更稳健的架构决策。 ## Atmosphere & style 整场演讲氛围轻松随和且充满极客式的幽默感,开场致敬主办方并穿插可爱的卷饼猫梗图,让技术探讨毫无沉闷感。Richard 的叙述条理清晰、抽丝剥茧,以平易近人的口吻将复杂的函数式数据结构与实际业务痛点融会贯通。聆听过程就像在与一位经验丰富的技术伙伴促膝长谈,没有浮夸的实时演示,却能带给听众一种豁然开朗、由衷点头的实用启发感。 ## Bulletin - [00:10](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=10s) Richard Feldman 提出“让不可能的状态变得不可能”的核心理念,倡导通过强类型系统在编译阶段杜绝非法数据组合,而非依赖运行时的校验与重排逻辑。 - [09:02](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=542s) 在设计数据模型时,应避免使用多个并行的 Maybe 或并行的 List;通过定义专属联合类型或将字段封装进单条记录,可彻底杜绝数据不对齐与非法状态。 - [14:14](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=854s) 借助 Zipper List 能够优雅建模非空导航状态,从类型层面同时保证“至少存在一项”以及“当前激活项必定在列表内”。 - [17:28](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1048s) 对外暴露 API 时应优先使用单构造器联合类型构建不透明类型(opaque types),隐藏底层数据结构以在重构时不引入任何破坏性变更(breaking change)。 ## Key takeaways - [00:10](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=10s) 许多耗费大量时间的 Bug 根源在于应用进入了“本不该可能发生”的状态,通过合理的模型设计可以在编译期彻底消灭它们。 - [04:02](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=242s) 在 elm-css 最初的设计中,所有样式声明被塞入同一个平铺列表中,导致用户可以随意破坏 CSS 规范中关于 @rule 的严格先后顺序。 - [05:50](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=350s) 与其编写繁琐的重排代码与测试用例去纠正非法输入,不如直接拆分数据结构,使非法样式表在语法层面无法被表达出来。 - [05:50](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=350s) “测试固然好,但让错误变得不可能发生更胜一筹”:若非法的测试用例连编译都无法通过,长期的维护负担将大幅减轻。 - [09:02](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=542s) 问卷应用中若将提示列表与回答列表分开存储,可能引发回答数量与题目数量脱节的神秘状态,应将二者绑定在单条记录中。 - [11:21](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=681s) 利用“首元素(first)配合其余元素列表(others)”的模式,可在类型系统层面强行约束列表非空,避免空题库的非法状态。 - [14:14](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=854s) 单纯引入 current 字段会导致当前题目可能不在列表中;引入 Zipper List(拉链列表)将结构拆分为 previous、current 与 remaining,可确保当前项天然属于列表且非空。 - [15:51](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=951s) 直接暴露底层记录结构会导致重构数据模型时破坏外部调用的兼容性,造成严重的破坏性变更(breaking change)。 - [17:28](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1048s) 使用单构造器联合类型替代类型别名,并在模块导出时隐藏构造器,可将数据类型变为不透明类型(opaque type),对外部调用方彻底隐藏内部布局。 - [17:28](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1048s) 通过模块暴露的辅助函数(如 questions、currentQuestion)向外部平铺输出数据,既能保障内部状态不可能出错,又为调用方提供了最简便的 API。 - [21:25](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1285s) 在状态栏与撤销场景中,并列使用两个 Maybe 字段容易陷入“未展示状态栏却挂起恢复数据”的矛盾状态,应使用专用的联合类型替代。 - [23:38](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1418s) 排查自省准则一:当想要添加第二个 Maybe 时,应优先考虑切换为一个承载不同业务分支的领域联合类型。 - [23:38](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1418s) 排查自省准则二:当想要添加第二个独立列表时,应优先考虑将元数据富化到单个列表的元素记录中。 - [23:38](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1418s) 排查自省准则三:从首个版本开始就要隐藏实现细节并构建不透明类型,避免调用方产生依赖,从而为未来重构保留无痛迭代的空间。 ## Detailed walkthrough ### [00:10](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=10s) 开场致谢与演讲主旨 在正式演讲开始前,Richard Feldman 提议全场起立鼓掌,向 elm-conf 的组织者们致敬。他感叹道,虽然这是组织团队第一次办大会,但全天演讲的精彩程度令人震撼;自己听完一场就祈祷“幸好我不用接着那场讲”,直到 Murphy 的分享作为最后的希望也同样惊艳全场。作为当天的压轴演讲,Richard 表示这场分享会更轻松(chill)、没有酷炫的实时 Demo,但希望能带给大家切实可行的收获。正如他在开场时所强调的:“Hopefully though this is going to be something practical something where you can walk away with less of a whoo and more of a so that's what we're going for here making impossible States impossible.”(希望这能带来一些实用的东西,让大家离场时不是发出‘哇’的惊叹,而是若有所思地点头——这就是我们的目标:让不可能的状态变得不可能)。 ### [01:17](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=77s) Elm CSS 与 CSS 规范的冷门规则 为了证明自己是个“讲道理、通情达理的人”,Richard 幽默地拿自己编写 CSS 预处理器来开刀,引出了他开发的库——elm-css。elm-css 的核心思路是用 Elm 代码生成 CSS 文件或内联样式(inline styles),语法结构尽量贴近原生 CSS,例如用函数调用来表示选择器与声明。该库最核心的设计目标之一是**仅生成合法的样式表(valid stylesheets)**,只要无法生成合规 CSS,就应当在编译期或验证阶段直接报错。 深入研究 CSS 规范后,Richard 发现让样式表变得非法的场景极多,其中最令他惊讶的是关于 `@rule`(如 `@media`、`@font-face` 等)中三个冷门规则的严格限制: - **`@charset`**:必须是整个样式表的绝对首字符。哪怕在它前面只有一个换行符,整个样式表都会直接失效(invalid);且全表严禁重复定义。 - **`@import`**:必须置于 `@namespace` 和常规样式声明(style declarations)之前;由于 `@charset` 必须在第一位,因此它只能紧随 `@charset` 之后。 - **`@namespace`**:必须在 `@import` 之后、常规样式声明之前声明。 这些规则意味着合规样式表必须严格按照“单个 `@charset` -> 多个 `@import` -> 多个 `@namespace` -> 常规样式”的分组顺序连续排列。 ### [04:02](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=242s) 初版 API 的设计陷阱与排序方案 在最初移植到 elm-css 时,Richard 凭直觉希望保留手写 CSS 的体验,将它们都设计成扁平的列表项:直接提供 `charset`、`import_`(因为 `import` 是 Elm 保留关键字而加下划线)、`namespace` 以及常规选择器函数。然而,一旦放在同一个列表 `List Declaration` 中,就意味着它们的底层类型完全相同。 这种统一类型的设计带来了严重的隐患:用户可以在列表中任意打乱顺序,比如把普通样式写在最前、在 `namespace` 与 `import` 之间反复交替,甚至在文末连写两个 `charset`。由于类型系统不加干预,这行代码能顺利编译,但若天真地直接输出为 CSS,就会违背前述所有规则。面对这个缺陷,Richard 最初构思的解决方案是**“校验与自动重排”(Validate and Sort)**: 1. **校验阶段**:若用户声明了多个 `charset`,则在验证步骤抛出错误阻止。 2. **重排阶段**:代码生成时自动纠错,强制按照规范顺序依次吐出 `charset`、`import`、`namespace` 和样式。 但这种方案意味着必须编写大量繁重的测试用例,覆盖交替穿插、重复定义等各种非法排列组合。 ### [05:50](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=350s) 架构重构:用类型消除非法状态 Richard 随后向同事 Evan Czaplicki(Elm 创始人)请教 API 设计。Evan 提供了一个截然不同的视角:“如果你直接让非法样式表根本无法被表达出来呢?如果数据模型本身就无法容纳非法的样式表呢?” Richard 意识到,自己之前将所有项塞进一个声明列表,只是在盲目模仿 CSS 的外在形式。既然规范要求它们具有严格的分块结构与数量限制,为什么还要赋予它们相同的类型?赋予它们相同类型反倒成了一种“反特性”(antifeature)。团队最终将数据模型重构为分离的字段: ```mermaid flowchart TD accTitle: elm-css Stylesheet Data Model accDescr: Schema showing how stylesheet properties are split into strictly typed distinct fields to prevent invalid ordering. subgraph Stylesheet["Stylesheet Record"] CS["charset: Maybe String<br/>(最多只允许一个)"] IM["imports: List Import<br/>(独立类型列表)"] NS["namespaces: List Namespace<br/>(独立类型列表)"] DC["declarations: List Style<br/>(纯常规样式声明)"] end CS --> IM IM --> NS NS --> DC ``` 这种数据模型带来了立竿见影的收益: - `@charset` 变为 `Maybe String`,自然限制为 0 个或 1 个,彻底杜绝多重定义。 - `import`、`namespace` 和样式声明各自拥有完全不兼容的独立类型,使用者根本无法写出交替穿插的代码,否则连编译都无法通过。 - 生成合法样式表变得极其直观:只需检查 `charset` 是否存在,再顺次输出列表即可。 对于这种架构带来的测试与设计转变,Richard 总结道:“Tests are good, but impossible is better.”(测试固然好,但让错误变得不可能发生则更胜一筹)。如果连针对非法状态的测试代码都因无法通过编译而写不出来,维护负担自然大幅减轻。此外,更严谨的数据模型也会反哺出更清晰的 API,强行引导调用方采用正确的方式组织数据。随后,Richard 将这一思想进一步引申到通用的前端业务开发中:如果不写底层库,普通的应用程序又该如何通过模型设计让非法状态彻底消失?他随即准备以一个具体的问卷调查(survey app)案例展开讲解。 ### [09:02](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=542s) 问卷应用的数据建模:将提示与回答耦合 Richard Feldman 引入了一个具体的案例:一个在线调查问卷应用。该应用的基本形态非常简单,页面上依次呈现一系列问题提示(prompts),例如“elm-conf 上最棒的部分是什么?”,并在每个提示下方提供一个文本框供用户输入回答(responses)。应用不断向用户提问,并通过输入框收集文本数据。 一种最直观的建模方式是将它们分别存为两个独立的列表:一个是提示列表 `prompts: List String`,另一个是回答列表 `responses: List (Maybe String)`。回答之所以用 `Maybe String` 表示,是因为用户可能尚未作答,状态为 `Nothing`;随着答题进行,逐步转变为 `Just "..."`。在正常的示例中,提示包括“你最喜欢的 elm-conf 回忆是什么?”、“这是真实的生活吗?”、“抑或只是幻觉?(引用波西米亚狂想曲歌词)”。对应的回答列表可能是第一题填入“所有的跳水观众(crowd surfers)!他们太棒了”,后面两道题由于未答则均为 `Nothing`。 然而,这种双列表设计隐藏着一个严重的设计缺陷:系统很容易陷入一种完全非法的状态——例如提示列表为空(`[]`),回答列表中却凭空出现了一个 `Just "Yes"`。这种状态在业务逻辑上是毫无道理的;一旦在运行时出现,说明业务逻辑在某处发生了诡异的崩溃。Richard 强调,与其在运行时遇到这种神秘状态后再去层层回溯调试代码,不如在编译期就让这种状态根本无法构建。解决方案非常直接:将提示与回答紧密绑定在同一个结构中,定义一个包含 `prompt` 和 `response` 的记录(Record),再维护该记录的列表。这样一来,任何提示必然附带一个回答槽位,任何回答也绝不可能脱离提示而独立存在。 > “如果这本该是不可能的,我们为什么要允许它?为什么要允许这种不可能的状态发生?” —— Richard Feldman ### [11:21](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=681s) 问题导航需求与非空列表建模 当问卷应用新增“导航(navigation)”功能时,设计变得更为复杂。用户不再必须按顺序作答,而是能够点击“上一题”和“下一题”,跳过难题稍后再答,或者返回修改先前的答案。为了专注于导航逻辑,模型中抽离出了导航历史(`History`)。 初步的建模方案是保留一个问题列表 `questions: List Question`,并增加一个当前正在作答的问题字段 `current: Question`。例如在关于糕点的问卷中,列表中包含关于蛋糕(cake)、派(pie)和饼干(cookies)的问题,而 `current` 指向“派”,表示用户当前停留在中间这道题上。但这种建模同样允许不可能的状态发生:`questions` 列表为空(`[]`),而 `current` 却依然显示用户正在回答关于“派”的问题。一个没有任何题目的问卷是毫无意义的,只要用户能够与之交互,系统中就必须至少存在一道题。 为了在类型系统层面强制保证“至少有一道题”,Richard 提出了利用类似列表模式匹配(pattern match)的拆分方式:用独立的 `first: Question` 字段表示首个元素,再用 `others: List Question` 包含后续的其余问题。从概念上看,将 `first` 与 `others` 进行拼接(cons)即可还原出完整的序列,但在类型约束上,它从根源上杜绝了题库为空的情况——无论如何,`first` 总是必须存在的。 ```mermaid flowchart LR accTitle: 从普通列表演变为非空列表结构 accDescr: 对比 questions List Question 产生空列表缺陷,与 first 搭配 others 确保至少一题的结构差异。 subgraph Flawed["脆弱设计 (允许 0 题)"] direction TB F_List["questions: List Question (可能为空 [])"] F_Curr["current: Question (派)"] F_List -.->|"脱节"| F_Curr end subgraph NonEmpty["强约束设计 (至少 1 题)"] direction TB N_First["first: Question (必须存在: 蛋糕)"] N_Others["others: List Question (后续题目: 派, 饼干)"] N_First --> N_Others end ``` ### [14:14](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=854s) 引入 Zipper 列表杜绝脱靶问题 即使利用 `first` 和 `others` 消除了空列表的可能性,上述模型依然存在另一个严重的漏洞:`current` 所指向的问题,可能根本不在问卷的题目序列中。比如,第一题是蛋糕,其余题目是派和饼干,但 `current` 却被赋值为“冰淇淋(ice cream)”。用户在界面上回答了一个完全不存在的问题,提交之后系统必然产生不可预料的行为。 为了解决这个问题,Richard 借鉴 Tessa Kelly 在数据结构方面的思路,引入了名为 **Zipper List**(拉链列表)的数据结构。Zipper 的核心思想是将列表沿着“当前聚焦项”拆分为三个独立部分: 1. `previous: List Question`:记录当前位置之前的所有问题; 2. `current: Question`:当前正在查看或作答的单一问题; 3. `remaining: List Question`:当前位置之后的所有剩余问题。 ```mermaid flowchart TD accTitle: Zipper List 数据结构示意 accDescr: 展示 previous、current 和 remaining 三部分如何拼装为完整的题目列表,且 current 永远包含在列表内。 subgraph Zipper["Zipper List 状态表示"] direction LR P["previous\n[1: 蛋糕, 2: 派]"] C["current\n[3: 饼干]"] R["remaining\n[4: 冰淇淋]"] P === C === R end Full["完整列表拼接结果: [蛋糕, 派, 饼干, 冰淇淋]"] Zipper --> Full ``` 在 Zipper 结构下,如果题目序列为蛋糕、派、饼干、冰淇淋,而当前停留在饼干,则 `previous` 为 `[蛋糕, 派]`,`current` 为 `饼干`,`remaining` 为 `[冰淇淋]`。要获取全部题目,只需将三者按顺序合并。这种设计带来了两项绝对的类型保证: - “当前问题不在问题列表中”变为不可能:因为当前问题本身就是该数据结构的核心锚点,完整列表必然由它参与构成。 - “题库为空”同样不可能:即使处于最极限的空状态,`previous` 和 `remaining` 都为空列表,也必定会留存一个 `current`。不可能的状态被彻底消除。 > “在最糟糕的情况下,即使这里空到了极点,也就是 previous 没有任何内容,remaining 没有任何内容,我们依然拥有 current。” —— Richard Feldman ### [15:51](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=951s) 数据结构重构引发的破坏性变更 在完善了底层模型后,Richard 话题一转,打趣地切入所谓的“升级体验”——幻灯片上放了一张被卷成墨西哥卷饼(Burrito)模样的猫咪图片,他随即笑着澄清这跟卷饼没有任何深奥的技术关联,纯粹是因为自己喜欢猫咪图片。 回归正题,导航模块的核心 API 通常需要暴露以下几个基础操作: - `History` 记录类型:供外部读取数据并渲染当前界面; - `back: History -> History`:将当前问题后退一步; - `forward: History -> History`:将当前问题前进一步; - `answer: Answer -> History -> History`:记录用户的作答,将内部的 `Nothing` 更新为 `Just`; - `init: Question -> List Question -> History`:传入首题与后续题目,初始化生成一个 `History` 实例。 然而,重构带来了新的架构难题。为了让内部表示更加健壮,底层的 Record 结构从原本包含 `questions` 字段改为了 `previous` 与 `remaining` 的 Zipper 形式。如果外部使用该模块的代码直接通过字段访问语法读取了 `history.questions`,那么这次内部优化就变成了一次致命的破坏性变更(breaking change),会导致现有的上层调用代码在编译时全线报错,因为 `questions` 字段已经不复存在了。这引出了如何在增强内部模型健壮性的同时,保持公开 API 稳定与平滑过渡的思考。 > “当我们在内部升级了表现形式、使其变得更加健壮的同时,在这个过程中我们实际上改变了记录的结构。” —— Richard Feldman ### [17:28](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1048s) 使用单构造器联合类型与不透明类型隐藏实现细节 理查德·费尔德曼(Richard Feldman)指出,我们在底层重构数据结构(例如从普通列表重构成 ZipList)完全是为了让内部状态更健壮,这本不应该演变成破坏性的重大变更(breaking change)。“所以,我们能不能做到让‘依赖特定实现细节’这件事变得不可能?我们能不能让任何使用我们 API 的人在我们升级库时不担心代码被破坏?是的,我们完全做得到。”解决这个问题的关键手法就是:用单构造器联合类型(single Constructor Union type)替代类型别名(type alias)。 在代码层面,原本的 `type alias History =...` 被改为 `type History = History { previous:..., current:..., remaining:... }`。这种包装虽然让内部解构数据多了一步操作——比如在写 `back` 函数时需要用 `case history of History { previous, current, remaining } ->...` 来模式匹配——但 Elm 支持在函数参数中直接解构单构造器联合类型,形如 `back (History { previous, current, remaining }) =...`,既简洁又安全。更核心的步骤在于模块的暴露控制(exposing):通常定义联合类型时会习惯性地写 `History(..)` 将类型及其构造器全盘暴露;但如果只写 `History` 而省略构造器 `(..)`,外部模块就只能在类型注解中使用该类型,完全无法对它进行模式匹配或直接访问内部字段,从而将 `History` 变成了不透明类型(opaque type)。 ```mermaid flowchart TD accTitle: 模块封装与不透明类型架构 accDescr: 内部模块封装真实数据结构,仅对外暴露安全函数和类型签名 subgraph ModuleInternal["模块内部 (Internal Implementation)"] A["ZipList 数据结构<br/>(previous, current, remaining)"] --> B["单构造器包装<br/>type History = History {...}"] end subgraph ExposingControl["暴露控制 (Module Boundary)"] B --> C["仅暴露类型: History<br/>隐藏构造器 History(..)"] B --> D["暴露辅助 API:<br/>questions, currentQuestion"] end subgraph ExternalConsumers["外部调用方 (API Consumers)"] C --> E["类型安全: 可用作类型注解"] D --> F["通过受控函数读取平铺数据<br/>无感知底层演进"] end ``` - 将外部代码与内部数据布局完全解耦后,外部若想获取问卷列表,不再使用字段访问 `history.questions`,而是调用模块暴露的专用函数,如 `questions: History -> List Question` 与 `currentQuestion: History -> Question`。 - 外部消费者通常只想获取一个简单的列表去渲染界面或导航链接,直接处理 ZipList 反而是负担;隐藏 ZipList 既保证了内部状态不可能出错,又为调用者提供了最简单舒适的 API。 - 升级内部实现时不再产生任何破坏性变更,用户完全不必感知底层的重大改造。 --- ### [21:25](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1285s) 状态栏与撤销逻辑:用领域专用联合类型替代双重 Maybe 接着,费尔德曼给应用增加了一个状态栏(status bar)需求:当用户编辑问卷时,顶部需要弹出一个黄色的提示条显示“问卷已创建(question created)”,旁边配个小喇叭图标。最直接的建模方式是引入一个 `status: Maybe String`,为 `Nothing` 时不显示,为 `Just "..."` 时显示对应文本。然而,现代应用往往还支持“问卷已删除(question deleted)”以及配套的“撤销(Undo)”按钮;为了实现点击撤销就能还原问卷的功能,应用必须暂存刚刚被删掉的那道题。 一种直觉的扩展思路是再加一个字段:`questionToRestore: Maybe Question`。此时状态组合便埋下了隐患:创建问题时是 `status = Just "..."` 搭配 `questionToRestore = Nothing`;删除问题时二者皆为 `Just`;可一旦代码出现疏漏,产生了 `status = Nothing` 却伴随 `questionToRestore = Just question` 的状态,系统的行为就会变得极其荒谬——既没有显示提示条,后台却悬挂着可还原的数据。费尔德曼直言:“这看起来又是某个地方出错了,我们的逻辑里出现了 bug……这本应该是不可能的。” 解决这一矛盾的做法是用一个贴合领域业务的专属联合类型取代两个独立的 `Maybe`,彻底消灭非法组合: | 状态分支 (Constructor) | 携带数据 (Payload) | 对应业务含义 | |:--- |:--- |:--- | | `NoStatus` | 无 | 无任何提示信息展示 | | `TextStatus` | `String` | 普通提示消息(如问卷创建成功) | | `DeletedStatus` | `String`, `Question` | 包含删除提示文字与待撤销恢复的问卷对象 | --- ### [23:38](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1418s) 总结与核心原则:三项排查自省清单 在演讲尾声,费尔德曼回顾并提炼了在 Elm 中消除非法状态的三个关键决策考量: 第一,是使用两个 `Maybe`,还是定制一个专属联合类型?费尔德曼结合自身经验谈到:“很多时候我从一个 `Maybe` 起步,感觉一切都挺好;尤其是有 JavaScript 背景的人,直觉往往就是顺手再往里塞一个 `Maybe`。但经常只要我多花一秒钟想想,就会发现:‘啊,其实这两个 `Maybe` 组合起来,肯定会出现我不想要的情况。’从一个 `Maybe` 直接切换成联合类型,往往远好于再追加第二个 `Maybe`。随着应用规模越来越大,这一点就越发正确。” 第二,是使用两个独立的列表,还是使用一个“每个元素包含两个字段”的列表?当开发者想在模型中引入第二个并行列表时,务必停下来审视数据归属,优先考虑将元数据直接富化到现有列表中,从根源上杜绝长度失配或索引不对齐的同步难题。 第三,我们能否在不破坏用户构建的前提下重构内部实现?费尔德曼告诫大家,这必须在一开始就有所规划,“一旦你把实现细节暴露出去,别人依赖上了,到那时想避免破坏性更新就已经太晚了。”因此,在首个版本中就默认隐藏实现、利用单构造器联合类型构建不透明类型,是维持长期 API 稳定的不二法门。最后,他总结呼吁:“如果代码中可能表示出那些本应不可能存在的状态,请务必考虑把这些‘可能’变成‘不可能’。” ## Notable quotes > [23:38](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1418s) 如果代码中可能表示出那些本应不可能存在的状态,请务必考虑把这些‘可能’变成‘不可能’。 — Richard Feldman > [23:38](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1418s) 从一个 Maybe 直接切换成联合类型,往往远好于再追加第二个 Maybe。随着应用规模越来越大,这一点就越发正确。 — Richard Feldman > [23:38](https://www.youtube.com/watch?v=IcgmSRJHu_8&t=1418s) 一旦你把实现细节暴露出去,别人依赖上了,到那时想避免破坏性更新就已经太晚了。 — Richard Feldman ## Mentioned Richard Feldman, Evan Czaplicki, Tessa Kelly, elm-css, Elm, CSS, elm-conf, Murphy ## Video description Among the most time-consuming bugs to track down are the ones where we look at our application state and say "this shouldn’t be possible." We can use Elm’s compiler to rule out many of these bugs in the first place—but only if we design our Models using the right techniques! This talk explores how. [Source](https://www.youtube.com/watch?v=IcgmSRJHu_8)

Source quotes

[23:38] Richard Feldman: 如果代码中可能表示出那些本应不可能存在的状态,请务必考虑把这些‘可能’变成‘不可能’。 [23:38] Richard Feldman: 从一个 Maybe 直接切换成联合类型,往往远好于再追加第二个 Maybe。随着应用规模越来越大,这一点就越发正确。 [23:38] Richard Feldman: 一旦你把实现细节暴露出去,别人依赖上了,到那时想避免破坏性更新就已经太晚了。