代码质量实际上意味着什么? 已翻译 100%

oschina 投递于 2017/09/04 14:56 (共 9 段, 翻译完成于 09-08)
阅读 2019
收藏 28
1
加载中

由 Erik Dietrich 撰写

我经常听人探讨“代码质量”这个术语。当然,我相信你也曾这样做过。在一个软件商店里停留几天是很难不听到有人说道这个词。但这也是问题的症结所在。当他们谈论它时,似乎所有人表达的意思都不是完全一样的。

举个例子,想想食物。如果我告诉你,我昨天晚上出去吃了高品质的食物,你可能会将自己的定义映射到我的经验上。也许你会描述为高价格、甘蓝和有机松果。这还太低级了? 也许小土豆+香煎牛脊也是很昂贵的。但无论哪种方式,明确的要点是高价格和有机食物。那这意味着什么? 也许对你来说,高品质的膳食是一种便宜的熟食三明治,谁在乎其来自哪里呢? 当然,如果你在森林里迷路了快一周了,你可能会重新定义高品质的食物,即可食用就是高品质。

Tocy
Tocy
翻译于 2017/09/04 15:18
1

你可能会得有这种想法。你判定食物的方法是主观的,也是场景依赖的。同样的道理也适用于我们对待代码的方法。当我们谈论代码质量时,我们把自己的语境和主观性带到其中。但是,就像食物一样,我们也倾向于认为人其他人明白我们内心的定义。我们可以将这称为天真现实主义的人类认知偏见

那么你会如何去解读代码质量,至少与他人达成一些共识呢?

Tocy
Tocy
翻译于 2017/09/04 15:26
1

代码质量:通过否定下定义

也许最简单的开始方式是从否定开始。毕竟,如果要说我们从 Software Engineering Stack Exchange 中学到些什么的话,我们知道了在该问题被作为“非建设性问题”关闭前,哪种构建代码质量的问题会激发数百个投票、大量的回答和诸多评论。我们也知道,人们可以投票选出代码质量的错误定义。

各个地域的人们似乎都认为质量差的代码引发后期阅读者的质疑。他们会在读过代码后高喊:“这是什么玩意?” 低质量的代码给我们带来困扰,就跟这个毁誉参半的卡通漫画一样。

Tocy
Tocy
翻译于 2017/09/04 15:39
0

我实际上认为这给之后的讨论开了个好头。 当你有质量差的代码时,它会使人困惑,难以理解。 因此,对它进行讨论似乎是理解代码质量的不错开始 —— 那人们会快速容易地理解它们。

当然,你可能会指出,任何代码都或多或少会混淆一些基本的软件知识。 所以也许我们应该考虑一下参考大多数相关技术软件开发人员的代码。

溪边九节
溪边九节
翻译于 2017/09/04 17:40
0

代码应专注于做该做的事

我们在迁移到简单直观的标准之前可以从反面设立一些探索点。一段高品质的代码,应该是普通开发者应该能够快速,轻松理解的代码。反之,则不能称之为高品质代码。

注意这会导致出现一种情况:一段极端聪明或者极具开创性的代码不能被冠以高品质。大体来说,我觉得这是可以的。如果你编写出了难以理解的算法,解决了一个独特的、有效的问题,也许代码质量评判不会给你最高的分数,你会备受打击。但你的贡献其实并不是这个函数本身的代码质量,而是这个函数解决了什么问题。

garybook
garybook
翻译于 2017/09/07 17:00
0

这也带来了关于代码质量的另一个重要特征。作为高质量的筹码,它应该为预期的目的服务。也就是说,高质量的代码没有缺陷、没有性能问题、没有安全漏洞,也没有其它与目的相悖的东西。草率的代码也可以达到目的(甚至可以完成得很好,尤其是在对某个问题产生创新解决方案的情况下),而且你应该能理解代码中会充斥着缺陷。它们都不是高质量的代码。但是可理解的代码,其目的是为了不让你出