不要让“Clean Code”更难维护,请使用“Rule of Three”

当人们试图将”代码整洁之道(Clean Code)”的原则应用于现有的代码库时,我经常会问这个问题。

我认为这是合情合理的。

当我们开始重构遗留代码时,通常会将内容提取到较小的方法中。然后再将方法提取到类中。很快,我们可能就能感觉到原来 30 行的方法现在已经分散在不同的类中。

我们想知道的是:这在实际上是否是更容易维护了呢。

也许我们是一个小团队。也许我们必须支持我们继承的一个相对较大(并且没有文档记录的)的代码库。

寻求代码可维护性是一件好事。

错误在于,认为代码可维护性与代码行数(lines of code,LOC)相关。LOC 可能是一个有趣的度量指标,但它并不是关键所在!

不要使用 LOC 作为代码可维护性的度量指标。

简短的代码并没有更好的可读性

如果你对此有所怀疑,那么应该看看”短码之美(Code Golf )”。

当我们进行”短码竞赛”时,我们的目标是找到一些聪明的技巧,用最少的代码字符来实现相同的功能:

但当然,这只是一个”strawman”的论点!

我相信我们不会以”短码竞赛”的方式来编写生产中的代码。

然而,有一个重要的原则,我们需要记住:

简而言之:编写代码是要供他人阅读的。

易于理解的代码才是易于维护的代码。

还是,难道我们还不够聪明,而无法阅读冗长的函数吗?出于可读性的考虑,添加一堆一次性使用的助手函数又有什么好处呢?

如果这些问题能引起我们的共鸣,那么我们需要知道一个秘密……

过早的重构是项目失败的根源

任何极端的做法都是有害的。

即使是遵循”代码整洁之道”的原则。

我们正在尝试一些事情。当然,我们可以按照最佳实践来重构代码,但这同时也会增加了维护的难度。如果我们为了达到此目的而只是封装了一个条件语句,那么它可能没有帮助!

不,我们不应该为了可读性,而将所有内容都提取到”一次性助手函数”中。如果我们每次阅读代码时都需要阅读这些函数的主体,那么这一点也没有帮助。它只会是阻碍。

我们应该做的是,创建正确的抽象。

正确的抽象,正确地划分职责。它们阐明了代码的意图。它们可以防止代码重复。

当我们找到正确的抽象时,我们会觉得这 4 个类实际上比原来的 30 行代码更易于维护。

但是,要找到正确的抽象确实很困难。因此,这就是我们应该关注的重点。

坏的抽象比重复更糟糕

你是否听说过”不要重复你自己(Don’t Repeat Yourself,DRY)”原则?

这是一颗共同发展智慧的明珠,而且非常有效。但它也经常被误解。

两段代码看起来是一样的,但却代表了不同的概念。不同的抽象。在这种情况下,重复是偶然的。保留重复会更好。

什么时候应该将代码提取到函数 / 方法 / 类中?什么时候应该保留重复?我们怎么知道我们有正确的抽象呢?

使用”Rule of Three”

Also called Write Everything Twice (WET). Pun intended.

这也称为”什么都写两遍(Everything Twice,WET)”。这是个双关语(与 DRY 原则相对)。

"三次重复攻击,就重构"

重构原则”Rule of Three”是一条经验规则,当我们有疑问时可以使用它。

在引入抽象之前,请等待第三次重复的出现。出现重复的次数越多,就越容易找到要提取的共性。

遵循”Rule of Three”原则。它能使我们更容易地找到正确的抽象。

超越”Rule of Three”

这里的”Rule of Three”原则是为了提醒我们,重复是可以的。

这也有点教条。就像”代码整洁之道”的原则一样,不要在任何时候都盲目地 100% 应用它。

有时,即使出现了 3 次重复,我们也可能找不到正确的抽象。不要强求对代码库进行过度的抽象。如果我们不能给它起一个清晰的名字,它就确实不够清晰。

毫无疑问,违反规则是可以的。等待更多的重复。

宁可重复,也不要错误的抽象。不要为了抽象而创建抽象。

如果抽象不好,则必须使用布尔型的参数和 if 语句来简化它的实现,以覆盖新的用例。这只是一种暗示、一种警告,告诉你你走错了方向。

如果我们还没有找到抽象的话,那也没关系。当我们有了更多的上下文时,仍可以重构它。等着瞧吧!

作者丨Nicolas Carlo

Original: https://www.cnblogs.com/88223100/p/Rule-of-Three.html
Author: 古道轻风
Title: 不要让“Clean Code”更难维护,请使用“Rule of Three”

原创文章受到原创版权保护。转载请注明出处:https://www.johngo689.com/612526/

转载文章受原作者版权保护。转载请注明原作者出处!

(0)

大家都在看

  • 由delete引起的锁扩大

    由delete引起的锁扩大 阿里云月报中的一句话,出处:http://mysql.taobao.org/monthly/2022/01/01/ 但是Ghost Record是可以跟…

    数据库 2023年5月24日
    096
  • MIT 6.824 Lab2D Raft之日志压缩

    书接上文Raft Part C | MIT 6.824 Lab2C Persistence。 实验准备 实验代码: git://g.csail.mit.edu/6.824-gola…

    数据库 2023年6月14日
    0153
  • 程序员“迷惑代码”大赏

    谈到程序员,对于外行人来说一贯的印象就是格子衫大裤衩外加人字拖,蓬头(秃头)垢面黑眼圈,还有就是”人傻钱多死得快”🤣,这是外界对程序员固有的思想,但是作为新…

    数据库 2023年6月11日
    094
  • MySQL8.0.x 安装傻瓜式教程【极简】

    MySQL8.0.x 安装 一、下载 MySQL官网下载链接:https://downloads.mysql.com/archives/community/ 选择版本后下载zip文…

    数据库 2023年5月24日
    086
  • 如何使用Intellij IDEA工具导入SVN项目

    步骤一:选择VCS 打开Intellij IDEA开发工具,在导航栏中选择 VCS栏位,如图。 步骤二:创建SVN地址 执行步骤二,可以看见打开了一个SVN Repositorie…

    数据库 2023年6月6日
    085
  • django-ckeditor上传图片到阿里云OSS

    参考信息 资料1: django_ckeditor上传图片到七牛云OSS 使用 1. 安装django-ckeditor 【参考 资料1 】 2. setting.py配置INST…

    数据库 2023年6月9日
    0101
  • dockerfile

    基本结构 Dockerfile 是一个文本格式的配置文件,用户可以使用 Dockerfile 快速创建自定义镜像。 Dockerfile 由一行行命令语句组成,并且支持以 # 开头…

    数据库 2023年6月14日
    088
  • 2020年十大最佳自动化测试工具

    Best Automation Testing Tools for 2020 对更快交付高质量软件(或”快速质量”)的需求要求组织以敏捷,持续集成(CI)和…

    数据库 2023年6月9日
    076
  • MySQL触发器

    触发器 先来个实际的案例 触发器概述 和存储过程一样,都是嵌入在MySQL服务器中的一段程序 触发器由 事件触发,比如INSERT ,UPDATE 等用户的动作或触发某项行为,自动…

    数据库 2023年5月24日
    098
  • 开发思想

    解决的问题:一类对象,不同对象有不同的处理 顶级接口 定义规范,面向接口编程 抽象策略 定义一套模板,不同的交给不同的策略实现 具体策略 枚举 对象标识 –具体策略 策…

    数据库 2023年6月11日
    079
  • java XML标记语言

    可扩展标记语言( Extensive Markup Language),标签中的元素名是可以自己随意写,可拓展是相对于html来说 标记语言:由一对尖括号括起来 用来当做配置文件 …

    数据库 2023年6月16日
    079
  • 控制反转(IOC容器)-Autofac入门

    注意:本文为原创文章,任何形式的转载、引用(包括但不限于以上形式)等,须先征得作者同意,否则一切后果自负。 简介 Autofac 是一个令人着迷的.NET IoC 容器。 它管理类…

    数据库 2023年6月14日
    082
  • mac(m1)配置my.cnf

    今天开始学习了数据库,在安装MySQL之后启动一直报错,然后在网上找了很多解决方法,最后用以下方法解决 对于习惯了windows的小伙伴来说,直接去安装目录里边修改my.ini就可…

    数据库 2023年5月24日
    0101
  • Java学习-第一部分-第二阶段-项目实战:坦克大战【3】

    坦克大战【3】 笔记目录:(https://www.cnblogs.com/wenjie2000/p/16378441.html) 坦克大战0.6版 √增加功能 2. 记录玩家的成…

    数据库 2023年6月11日
    0103
  • idea 自定义注释模板

    自定义的格式: html;gutter:true; * * * @Description * $param$ * @Author $user$ * @Date $time$ $da…

    数据库 2023年6月16日
    056
  • 【MySQL】MySQL的安装、卸载、配置、登陆和退出

    1 MySQL安装 安装环境:Win10 64位软件版本:MySQL 5.7.24 解压版 1.1 下载 https://downloads.mysql.com/archives/…

    数据库 2023年5月24日
    092
亲爱的 Coder【最近整理,可免费获取】👉 最新必读书单  | 👏 面试题下载  | 🌎 免费的AI知识星球