从零开始的状态机漫谈（3）——状态机设计原则：清晰！清晰！还是清晰！

悠悠 2022-11-04 00:50 6阅读 0赞

**【说在前面的话】**

--------------------

我们常说**状态机是一种思维方式、一种工具，同时它也是一种拥有极高自由度的语言**。说到语言，类比我们日常使用的口语，你会发现：有的人表达能力很强——说话条理清晰、逻辑严密、详略得当——能充分表达自己意图的同时还很凝练；相对的，有人颠三倒四、缺乏逻辑性还罗里吧嗦一大堆——在需要认真交换观点（而不是闲聊）的场合，往往沟通双方都很憋屈——大有一副茶壶里煮饺子，有货倒不出的感觉。其实，**作为一种翻译思维的语言工具，不同人在使用状态机时也有类似的表达能力的问题**。

回顾下之前介绍的内容：

*  [《从零开始的状态机漫谈（1）——万物之始的语言》][1]一方面介绍了状态机在计算机科学中的核心地位，另一方面着重介绍了一种嵌入式环境下容易使用的状态机图例；
 *  [《从零开始的状态机漫谈（2）—— switch：你的状态机初恋》][2_ switch]介绍了一种以switch为核心的状态图翻译方式；

本文介绍的设计原则对状态机来说虽然是具有通用意义的，但所使用的图例以及对应的代码翻译规则却是建立在前两篇文章的基础上的，因此**还没有阅读过以上内容的小伙建议首先通过上述链接阅读下之前的内容**。

**【功能单一原则】**

--------------------

人类是视觉主导的“动物”，具体表现为：对于同样的信息，一张优秀的图片往往能让人秒懂，而对应的优秀文字描述哪怕写的简单易懂，人们通常也需要花费数倍的时间来阅读。这里的原因其实很简单——对于图片，人类是并行处理的；而对于建立在阅读之上才能理解的文字，人类采用的是一种“连蹦带跳”的顺序处理方式。并行和顺序处理的在时间效率上的差异，可见一斑。

在普通的应用逻辑中，使用状态图描述逻辑也具有这种“让人一目了然”的潜力；理论上，通过读图理解设计者意图的速度应该远高于直接阅读翻译后代码的速度——遗憾的是，实践中由于缺乏正确的设计原则指导，很多人绘制的状态图恐怕还不如代码看起来好懂。空口白牙，抽象的很，我们不妨举个例子：

![图片][afd928a1eae759138eddcf550a27181e.png]

一般来说，**在全状态机开发下，永远都应该“先画图”，觉得逻辑没有问题的情况下，再“根据状态图来无脑的翻译代码”**——这对一张白纸的初学者来说往往很容易做到；遗憾的是，对大部分已经有几年工作经验，习惯了线性逻辑开发的人来说就有点困难了。比如，当我们说要设计一个输出字符串的状态机，对很多人来说，首先出现在大脑中的不是一张状态图，而是类似如下函数的一个参考代码：

//! \brief 通过外设非阻塞的输出一个字节extern bool serial_out(uint8_t cbByte);
    void print_str(const char *pchStr){
           if (NULL == pchStr) {
               return ;    }    //! C语言中，字符串一般以 '\0' 作为结尾    while (*pchStr != '\0') {
               //! 由于外设比较慢，输出不一定每次都成功        while(!serial_out(*pchStr));        pchStr++;    }     }

作为参考代码，显然，所有人都知道阻塞是大问题，只要把这个代码改为非阻塞的就行了，于是基于上述代码在脑海中先入为主的影响，很容易“逆向”出如下的状态图：

![图片][b821abf4c98106bc3b7c0dcbb65bb7bf.png]

这个图从严格的语法意义上来说完全合格，只不过阅读起来有点痛苦——虽然只有一个状态，但猛然让一个第三人阅读，估计要花费不少的时间，可能的原因如下：

*  这个状态有三个跃迁
 *  这个状态实际上拥有两个功能：
    
    1.  通过serial\_out()函数输出字符
    2.  判断字符串的尾部

我们说这个图虽然语法上正确，但是违反了一个很重要的状态图设计原则——功能单一原则。所谓功能单一原则是指：**每个状态的功能要尽可能单一，要避免将多个功能复合在同一个状态上，从而产生所谓的“超级状态”的情况**。设计出**超级状态并不是什么值得骄傲的本事**，它单纯：

*  增加了旁人（以及几个月后的自己）阅读和理解状态逻辑的难度
 *  增加了修改和扩展状态图的难度
 *  增加了白盒分析的难度
 *  几何状的增加了单一一个状态所拥有的跃迁的数量

回头再看前面的例子，很容易发现，它违反了状态功能单一原则：将字符输出和判断字符串尾部的功能集成进了同一个状态，从而产生了一个拥有3条跃迁的超级状态。基于状态功能单一原则，一个更好的设计如下：

![图片][e6df3456d3535540cd7b864c5c35c3e1.png]

在这个图中，虽然状态数量变成了两个，但它们分工明确功能单一，阅读起来较为简单，也非常容易发现上一张图中不太容易发现的逻辑问题——比如前一个状态图如果字符串是空串“”，就会产生内存访问越界的致命bug，而通过拆分成两个状态，很容易注意到“IS End Of String”状态所处位置对空串的敏感度——这也是功能单一原则增强了白盒测试（肉眼看图找bug）能力的一个强有力的证明。

有的小伙伴可能会说，前一个状态图其实也不是很复杂啦，我就能看懂。对此，我想说：前面的例子终究只是一个为了介绍问题而引入的例子，本身不会太复杂，讲清楚问题就行了。而在实际应用中，在缺乏“功能单一”原则的限制下，鬼知道设计师会复合出怎样的“蜘蛛精”；

超级状态的成因之一是一部分人受到先前习惯的影响，虽然是设计状态机，但总是无法自控的“先有代码在脑海里”然后“再逆向”绘制出对应的状态图。这个习惯说实话很难克服，也非常容易理直气壮的产生“自以为是在优化代码”的超级状态。针对这种心理，我们不妨强调下状态机设计的正确流程：

*  状态机设计的第一步永远都是逻辑设计，追求的是清晰，此时绝不需要考虑所谓的代码翻译时如何才能做到最优；
 *  状态图才是真正的源代码，而翻译后的C代码则是“汇编”；
 *  任何针对状态机的修改都必须从状态图开始，完成逻辑修改后，无脑的翻译成代码来查看运行效果；
 *  当且仅当状态机的逻辑已经经过验证，确认是正确无误的情况下，如果确实有用户需求或者系统性能没有达到要求，此时才进入状态图优化阶段——这里遵守的原则是：先优化状态图，最后万不得已的情况下才去优化翻译后的代码。

说了这么多，我们不妨再用一个例子实际操作一下：假设我们要设计一个状态机，从用户那里识别单词"OK"——其中一种最无脑的设计思路如下：

从逻辑的角度来说，很容易想到，对每一个字符来说，我们都有两个阶段：

1.  读取字符输入
2.  判断字符是否是我们想要的目标字符

因此很容易无脑的画出如下的状态机：

![图片][3357584cdabc2ec86e7a912d16d962bd.png]

--------------------

眼尖的小伙伴可能已经注意到，这个图中引入了一个新的名为***reset***的小圆点，它的功能也很直接：当跃迁到***reset***小圆点时，状态机复位，并返回***on-going***。一个系统中可以有多个***reset***小圆点。有的小伙伴可能要问，为啥不是“跃迁到状态机的第一个状态”而一定要使用***reset***小圆点呢？原因主要有二：

*  避免第一状态扇入过多，导致状态图太丑；
 *  如果使用跃迁到第一个状态的方法，则每一个跃迁都可能要重复去做类似初始化的工作——每多一条跃迁就多了一个重复的内容——这里如果不是简单复制粘贴的话，可能还会出现在漫长的代码维护过程中出现“某些跃迁的动作与其它不一致”从而给自己挖坑的情况；使用***reset***可以确保状态机复位，从而安全的从唯一的***start***点进入，完成统一的初始化动作。

--------------------

尽管有的小伙伴会说：“这个状态机看起来好蠢啊”，“这个状态机看起来一点通用性都没有”，但我要说，领会下精神啦，这只是我用来介绍方法论的例子，实际应用当然不会这么设计，但不管怎么说，这个状态机很清晰有木有？就是非常简单直接的“一二一二……”步骤的无脑叠加——而这种功能单一、逻辑清晰的无脑叠加正是状态机设计思维的一种体现——先逻辑清晰，一切都对了再考虑要不要优化。

然而，没有对比就没有伤害，我们再来看看一个反例——当我们先有代码在脑海里“挥之不去”，再“逆向”出状态图时会发生什么。

一个很容易想到的“最优”代码如下：

fsm_rt_t check_ok(void){
           uint8_t chByte;    ...    switch (s_tState) {
               ...        case RCV_O:            if (!serial_in(&chByte)) {
                       break;                            }            if (chByte != 'O') {
                       CHECK_OK_RESET_FSM();                break;            }            s_tState = RCV_K;        case RCV_K:            if (!serial_in(&chByte)) {
                       break;                            }            if (chByte != 'K') {
                       CHECK_OK_RESET_FSM();                break;            }            CHECK_OK_RESET_FSM();            return fsm_rt_cpl;    }        return fsm_rt_on_going;}

受其影响，“逆向”出的状态图如下：

![图片][fcf98edf2427a9c3ee105d46794a4dc9.png]

看到这个状态图，很多小伙伴估计要不淡定了？“傻孩子你是不是打自己脸了？”“这个图看起来明明看起来更直接啊？状态更少，而且对应的代码明显更优化啊！”

![图片][117866e9af1000b5f45b51dd7bbea342.png]

别急别急，好汉先看完下面的内容再打不迟。

**【如何在“结构清晰”和“性能优化”之间取得平衡】**

--------------------

在前面的讨论中，我们遇到了状态机设计的一个非常实际的问题：在追求逻辑清晰的时候，似乎由于状态的增多，代码执行的性能受到了某种影响——它表现在当翻译成switch状态机时，增加了太多不必要的状态切换，从而影响了当前状态机的执行效率。比如：

![图片][3357584cdabc2ec86e7a912d16d962bd.png]

这里，每次成功阅读到一个字符后，在翻译成switch状态机后，居然要到下一次才能对字符进行判断，而判断后居然又要退出状态机，再下一次才能开始新的一轮字符读取——这个状态机也实在太“卑微”了。考虑到《[实时性迷思（2）——“时间片轮转”的沙子][2]》中推导出的结论：非必要的频繁任务切换会浪费大量的处理器时间，从而影响系统的实时性，这里由状态切换导致的频繁CPU出让（yield）实际上并非好事。

**难道我们必须要在“****逻辑清晰****”和“****性能优化****”中做出取舍么？**

![图片][998d806bd11a9eb20bfaf143a022d612.png]

先别着急下结论，分析上面的原因容易发现：

*  遵循状态功能单一原则会产生多个简单状态，逻辑清晰，阅读简单；
 *  现有的状态切换过程中根据翻译方式的不同“有可能”出让CPU时间给其它任务；

那么，如果有一种方法能在**状态切换的过程中明确“标注”不要出让CPU控制权（避免yield）**是否就能解决问题了呢？比如，**我们把此类切换从实线箭头修改为虚线箭头**——表示此类切换不“主动”出让CPU控制权，则修改后的图如下所示：

![图片][b6fe685a94b9369453eb56f151fa7a9e.png]

那么在switch状态机中，这类“不让出CPU”的切换，实际上就是“切换任务的同时确保不会退出状态机函数”。要想做到这一点有两种方式：

*  使用goto
 *  使用switch的fall-through特性

--------------------

如果你对switch的fall-through特性感到一头雾水，可以去找一本经典的C语言教程看一看，或者参考这里的博文（https://c-for-dummies.com/blog/?p=3607）

--------------------

实际上，这里并不需要比较二者的优劣。一般来说，fall-through具有瀑布一般一泻千里不能回头的特性；而goto则适用于那些需要“逆流而上”的场合。作为例子，我们不妨使用新的方法翻译前面的状态图：

fsm_rt_t check_ok(void){
           uint8_t chByte;    ...    switch (s_tState) {
               case START:            s_tState = READ_CHAR_0;            // break;    //!< fall-through实现虚线切换        case READ_CHAR_0:            if (!serial_in(&chByte)) {
                       break;                            }            s_tState = IS_O;            // break;    //!< fall-through实现虚线切换        case IS_O:            if (chByte != 'O') {
                       CHECK_OK_RESET_FSM();                break;            }            s_tState = READ_CHAR_1:            // break;    //!< fall-through实现虚线切换        case READ_CHAR_1:            if (!serial_in(&chByte)) {
                       break;                            }            s_tState = IS_K;            // break;    //!< fall-through实现虚线切换        case IS_K:            if (chByte != 'K') {
                       CHECK_OK_RESET_FSM();                break;            }            CHECK_OK_RESET_FSM();            return fsm_rt_cpl;    }        return fsm_rt_on_going;}

通过观察可以发现，上述代码借助fall-through的特性取得了跟前一章节参考代码几乎无异的执行性能——实际上，聪明的你已经发现，在**确有必要的情况**下，**可以在状态机的优化阶段对上述代码进行进一步的优化，从而得到与此前参考代码一模一样的结果**：

至此，我们实际上明确了状态机的日常设计步骤：

1.  按照状态功能单一原则，以逻辑清晰为基本目标，再完全不考虑优化的情况下，完成状态机的设计和调试；
2.  在完成了状态机逻辑正确性验证的前提下，在必要的情况下，可以对状态图进行性能优化；
3.  如果经过上述步骤，性能仍然达不到要求，可以对翻译后的代码进行进一步的等效优化。

注意，以上过程是单向不可逆的。一般会把步骤1和步骤2视作“一次迭代”，敏捷开发中可能会允许用户进行多次迭代。

**【条件太多怎么办】**

--------------------

很多时候，虽然借助“虚线切换”可以在性能和清晰度上获得一定的平衡，但如果一个状态机状态数量太多，难免会让人眼花缭乱。就前面的状态图check\_ok来说，这只是识别两个字符，如果字符一多，图岂不是直接爆炸了？

![图片][b6fe685a94b9369453eb56f151fa7a9e.png]

也许不是一个很好的例子，但如果真的能省略掉图中“IS\_O”和“IS\_K”两个状态，并且仍能保证清晰的逻辑，岂不美哉？为了应对这种情况，我们引入了新的图例：公共条件（***common condition***）和子条件（*sub condition*）。那么，如何理解这两个新的概念呢？

此前，我们的状态模型上，每个跃迁都由两部分组成：跃迁的条件（***condition***）和跃迁时执行的一次性动作（***action***）：

![图片][f7488699a71272a1259d0f62354fd849.png]

这一模型可以应对大部分较为简单的情况，但实际应用中，一个状态的所涉及的具体行为可能会产生不止一个返回值，比如：

serial_in(&chByte);

就产生了两个有效的返回值：

*  ***serial\_in()*** 函数的 ***boolean***值，表示读取成功还是失败；
 *  当读取成功时，保存在 ***chByte*** 中的字符也就成了一个我们要判断的返回值；

对于这种源自同一个状态的动作而产生的多个返回值，我们可以借助前面所说的“公共条件”和“子条件”的方式加以简化：

![图片][7d0bd31c78bb96ba8c98428eeb3008d3.png]

根据这一方式，修改前面的状态图如下：

![图片][17e3eae242423c0184fd0b357a246a08.png]

怎么样，是不是又清晰又简单呢？它的switch状态机代码如下：

fsm_rt_t check_ok(void){
           uint8_t chByte;    ...    switch (s_tState) {
               case START:            s_tState = READ_CHAR_0;            // break;    //!< fall-through实现虚线切换        case READ_CHAR_0:            if (!serial_in(&chByte)) {
                       break;                            }            if (chByte != 'O') {
                       CHECK_OK_RESET_FSM();                break;            }            s_tState = READ_CHAR_1:            // break;    //!< fall-through实现虚线切换        case READ_CHAR_1:            if (!serial_in(&chByte)) {
                       break;                            }            if (chByte != 'K') {
                       CHECK_OK_RESET_FSM();                break;            }            CHECK_OK_RESET_FSM();            return fsm_rt_cpl;    }        return fsm_rt_on_going;}

是不是似曾相识？

![图片][a7706f8b967afac90ce9c77d87a9f3d8.png]

这不就是之前的所谓最优代码么？！

**【八状态准则】**

--------------------

借助前面介绍的方法，我们不仅能优雅的设计出逻辑清晰的状态图、兼顾翻译后代码的性能，还能在不影响逻辑清晰度的情况下减少状态的数量。至此，“单纯根据傻孩子我的经验”，这里“粗暴的”提出一个名为“八状态”的经验准则，即：

![图片][8e9c18b3d24d00062ce4b563c8cdc38e.png]

*  一个优秀的状态机通常不应该拥有超过八个以上的状态；
 *  如果你的状态机超过了八个状态，那么一定存在状态图层面的优化可能；
 *  除了前面介绍过的能够减少状态的方法以外，将一部分高度相关（可能也重复出现）的状态提取成为子状态机，往往也能有效的减少状态的数量。

【后记】

--------------------

使用状态图来设计状态机，其本意就是利用人类的视觉优于阅读能力的特性来降低设计难度。为了确保这一初衷能够贯彻始终，“逻辑清晰”就成为状态图设计的核心原则。

本着清晰第一的原则，首先要确保状态机逻辑正确，也就是常说的：先让功能跑起来没有问题；然后再考虑所谓的优化的问题。此外，对于有经验的老工程师来说，要尝试克服设计状态图时满脑子都是具体代码实现的弊端——至于这样，才能真正拥抱使用状态机进行开发的思维方式。

[1]: http://mp.weixin.qq.com/s?__biz=MzAxMzc2ODMzNg==&mid=2656102241&idx=2&sn=62cd0b5575cf77a8f3a56fa5d34e737d&chksm=8039c49eb74e4d886be9d1d6968e9d17e5e1817113541cf0b48c6e167a4d5db38ce7a6d69603&scene=21#wechat_redirect
[2_ switch]: http://mp.weixin.qq.com/s?__biz=MzAxMzc2ODMzNg==&mid=2656102694&idx=1&sn=80326f2f645d766259db72e14bba7a48&chksm=8039cad9b74e43cf3107f9719f95a863c4d4d662c3f0768d45dc7cd778261545bcfe34102f43&scene=21#wechat_redirect
[afd928a1eae759138eddcf550a27181e.png]: /images/20221023/ba6d3b2bc0504ad299876d9b1d26b7a0.png
[b821abf4c98106bc3b7c0dcbb65bb7bf.png]: /images/20221023/86f68519fe5d4fee9d8356a04a384894.png
[e6df3456d3535540cd7b864c5c35c3e1.png]: /images/20221023/7d89ad4305f74c1c9161e1ce090e1b39.png
[3357584cdabc2ec86e7a912d16d962bd.png]: /images/20221023/f4b854bec595424ba7006a6a90069ff9.png
[fcf98edf2427a9c3ee105d46794a4dc9.png]: /images/20221023/20ee33cb5cf44a33a295c4aef062896c.png
[117866e9af1000b5f45b51dd7bbea342.png]: /images/20221023/bb616bb393464179abf8a59f5e36a9a0.png
[2]: http://mp.weixin.qq.com/s?__biz=MzAxMzc2ODMzNg==&mid=2656102622&idx=2&sn=c424fb16e4db718047c19736be87a374&chksm=8039cb21b74e423744caa2d8876ae55be20ce6231e603c2825bb2af70a7424c5dafef3bd1ff8&scene=21#wechat_redirect
[998d806bd11a9eb20bfaf143a022d612.png]: /images/20221023/9b2a9d77e34b49b493232d10aec0908c.png
[b6fe685a94b9369453eb56f151fa7a9e.png]: /images/20221023/0de79a7e03cf4017b2671d556f0ad9b9.png
[f7488699a71272a1259d0f62354fd849.png]: /images/20221023/30dc326aa7e842668eb6b674ccdee457.png
[7d0bd31c78bb96ba8c98428eeb3008d3.png]: /images/20221023/c9dacf8761c2480b9c8d18c426c7b8ea.png
[17e3eae242423c0184fd0b357a246a08.png]: /images/20221023/7ce2375ebeea4679a4c254bf4b2afefc.png
[a7706f8b967afac90ce9c77d87a9f3d8.png]: /images/20221023/27ccc35d21504baeb18d7009c2026f6e.png
[8e9c18b3d24d00062ce4b563c8cdc38e.png]: /images/20221023/8c0093c5c6db41339e3277244e1ec44c.png