V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
wayn111
V2EX  ›  程序员

什么是好代码/坏代码?给普通人的图解示例

  •  2
     
  •   wayn111 ·
    wayn111 · 2023-05-14 16:37:25 +08:00 · 1516 次点击
    这是一个创建于 560 天前的主题,其中的信息可能已经有所发展或是发生改变。

    本文翻译自国外论坛 medium ,原文地址: https://medium.com/@todbotts.triangles/what-is-good-bad-code-an-illustrated-example-for-non-programmers-1222b600a0f0


    我曾经在某个地方读到过一句话,基本上有以下内容:

    在现代世界中,许多人的生活依赖于软件,例如控制大型商用客机飞行系统的软件,但软件开发领域大多不受监管。任何人都可以成为自学成才的软件开发人员,而且没有像其他高风险职业那样的认证或严格要求,比如摩天大楼建筑或神经外科。这是一个危险的不受监管的领域,因为根据情况,几行坏代码实际上可能会导致生命损失。

    那么作为外行,什么是“坏代码”?

    作为一个每天大约 5 个小时编写、审查和重构代码(意思是,以更简洁和可用的方式重新编写)的人,我知道什么是代码(以及什么是坏代码,相信我!)。有时我忽略了一个事实,即许多人对代码是什么,没有概念。

    对于那些人,我对 “你是程序员,你是做什么的?” 这个问题给出了以下答案,打个比方:

    我开发了一个非常细微小门的电子开关组件,以不同的方式和不同的配置打开和关闭门。当门打开时,电可以通过,当门关闭时,电被阻挡。由于门太小,不能手工建造,我不得不让人用电脑建造它们。根据我在电脑上输入的单词,它会代表我建造各种类型的这些小门。

    毫无疑问,正如上面的回答所述,软件开发人员 /程序员实际上是在构建具有物理存在但太小而看不见的东西(然而,可以将其想象为集合或一组小门)。这本身就够疯狂的了,但是如果您至少可以想象一下这些场景(比如列车控制程序、飞机飞行时的导航程序),那么您已经对什么是 “编码” 有了一个概念性的理解,祝贺您!那么回到这一节标题中的问题 — 什么是 “坏代码”?

    按照我们对小门的微小组合的比喻,我会说坏代码意味着你有太多的门,以不必要的重复或复杂的方式排列。

    由于很难用门做比喻来进一步形象化或解释,在这一点上我想提供另一个比喻,如下所示。

    打造一个旋钮调节器!

    假设我们想要构建一个旋钮调节器。一个可以旋转的旋钮,它会依次旋转远程位置的另一个旋钮。产品要求如下图。转动一个旋钮,远处的另一个旋钮也会转动: 这就是我们需要的系统——一个旋钮可以转动另一个旋钮。

    坏代码只考虑手头的问题,并提出最简单的解决方案,一个旋钮和一个旋钮调节器,由半柔性杆连接。在这个早期阶段,坏代码赢得了奥卡姆剃刀奖(开发速度非常快)。好的代码起初似乎有点矫枉过正,使用了橡胶带和 2 个轮子(开发速度较慢)。 坏代码得一分!简单,几乎没有活动部件!

    需求变更,旋钮位置变了!

    就像在开发周期中经常发生的那样,在某个时刻,客户需求会发生变化。在我们这里的比喻中,客户现在想要一个旋钮旋钮,可以旋转位于原始旋钮侧面的另一个旋钮,如下所示: 哎呀!产品需求变更!

    坏代码需要添加一些偷工减料的组件,使整个系统更加摇摇欲坠并且容易出现故障。好的代码只需要在新需求进来时稍微调整一下,简单地使用更长的橡胶带就可以解决这个问题。 坏代码已经成为摇摇欲坠的组件的混合物……

    要求更改,旋钮需要转得慢一些!

    最后,我们的客户决定他们希望旋钮以不同的速度旋转。输入旋钮的小旋转应该会导致连接的旋钮大旋转。

    鉴于这一新要求,不良代码需要向系统添加更多组件,从而使其更加复杂。另一方面,好的代码同样只需要稍微调整,在连接的旋钮侧使用更大的轮子: 两个插入物和一个滑稽的杆子?谁在维护你的同时,坏代码?

    总结

    如上所述,当需求很简单时,好的代码通常看起来有点过头,但当客户需求发生变化时,好的代码就会真正发光发热。换句话说,它能适应未来的规模和变化。另一方面,对于简单的问题来说,坏代码看起来很简单,很棒,但当系统发生变化或复杂性增加时,它就会变成噩梦。

    但也许你在想,“好吧,上面概述的两个系统都达到了相同的结果——旋钮调节器在任何一种情况下都能成功工作。”

    然而,从本质上讲,专业编码是一种协作努力,无论您编写什么代码,无论是现在还是将来,其他程序员都需要不断地阅读和接手这些代码。如果代码能尽可能容易被理解,这些程序员的工作将会更容易和更有效率。

    那么假如说你是初级开发人员,从其他开发人员那里接管代码库,您更愿意听到下面哪个消息?

    1. “这是我们的旋钮调节器,它由 2 个轮子和一条皮带组成”,或者
    2. “这是固定连杆的插件,这是连杆,你必须将它的末端插入另一个插件的小孔中……”
    7 条回复    2023-05-15 22:14:24 +08:00
    wayn111
        1
    wayn111  
    OP
       2023-05-14 16:38:28 +08:00
    觉得博主翻译不错的,可以关注公众号 [waynblog] 每周分享技术干货、开源项目、国外优秀文章翻译、高效开发工具等。
    voidmnwzp
        2
    voidmnwzp  
       2023-05-15 00:07:07 +08:00 via iPhone
    说白了就是引用对方模块时用接口解耦
    snowspace
        3
    snowspace  
       2023-05-15 11:28:48 +08:00   ❤️ 1
    Good code = my code
    Bad code = your code
    😂
    Rakkael
        4
    Rakkael  
       2023-05-15 15:00:43 +08:00
    喜欢好代码与烂代码这个题材,还有其他的推荐吗?
    hzzhzzdogee
        5
    hzzhzzdogee  
       2023-05-15 15:11:24 +08:00
    wayn111
        6
    wayn111  
    OP
       2023-05-15 22:12:38 +08:00
    @voidmnwzp 是这个道理
    wayn111
        7
    wayn111  
    OP
       2023-05-15 22:14:24 +08:00
    @Rakkael 哈哈,还有怎样成为优秀的后端工程师 https://v2ex.com/t/938750
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1177 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 22ms · UTC 18:04 · PVG 02:04 · LAX 10:04 · JFK 13:04
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.