知识卡片

普通读书笔记卡 · 6068.m

短函数以职责衡量

理解等级:中级

超长函数常把多个阶段和职责挤在一起,可按逻辑拆成有意义的子函数以便理解。行数阈值可以作为团队发现问题的提醒,但不是正确性的证明;拆分后若名称无意义、上下文频繁跳转,也未必改善阅读。最终检查的是职责和表达。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 2 处

    • · 查看原书依据

      没有一个绝对的量化标准,各团队可以有自己的标准,不同的开发语言可能会稍有不同。如果是Java语言,我建议一个方法不要超过20行代码,当我把这个规定作为团队代码审查的硬性指标后,发现代码质量得到了显著的改善。

    • · 查看原书依据

      短函数也不一定就意味着职责单一。 (2)在使用组合函数模式时,要注意抽象层次一致性原则(Single Level of Abstration Principle,SLAP),不同抽象层次的内容放在一起会给人凌乱、逻辑不协调的感觉。

    参考来源

    - 位置:《代码精进之路:从码农到工匠(异步图书)》3.5 短小的函数(spine1;extracted/代码精进之路:从码农到工匠(异步图书)/_epub-src/OEBPS/text00000.html;u045-ch03-008)。 - 结论依据:原文在“没有一个绝对的量化标准”附近的定义、实例或代码支撑本卡的核心说明:超长函数常把多个阶段和职责挤在一起,可按逻辑拆成有意义的子函数以便理解。适用边界按该处前提解释,代码未执行。 - 原始内容:没有一个绝对的量化标准,各团队可以有自己的标准,不同的开发语言可能会稍有不同。如果是Java语言,我建议一个方法不要超过20行代码,当我把这个规定作为团队代码审查的硬性指标后,发现代码质量得到了显著的改善。 - 位置:《代码精进之路:从码农到工匠(异步图书)》9.2 函数分解(spine2;extracted/代码精进之路:从码农到工匠(异步图书)/_epub-src/OEBPS/text00001.html;u147-ch03-008)。 - 结论依据:原文在“短函数也不一定就意味着职责单一”附近的定义、实例或代码支撑本卡的核心说明:超长函数常把多个阶段和职责挤在一起,可按逻辑拆成有意义的子函数以便理解。适用边界按该处前提解释,代码未执行。 - 原始内容:短函数也不一定就意味着职责单一。 (2)在使用组合函数模式时,要注意抽象层次一致性原则(Single Level of Abstration Principle,SLAP),不同抽象层次的内容放在一起会给人凌乱、逻辑不协调的感觉。