写出一手烂代码的19条准则 _烂代码

机器之心报道
参与：思

要是想写个烂代码，我们只需遵守这十九条准则？

文章插图

「代码写得好」是对机器学习研究者及开发者最好的赞扬。其第一层意思是说，你的模型非常好，有自己的理解与修正；第二层意思是说代码的结构、命名规则、编写逻辑都非常优秀。
我们曾经将写代码比喻成写文章：不仅需要有一个主旨，告诉别人代码的作用是什么，同时还应该在精炼与易读之间做权衡。代码过于精炼，整体逻辑难以跟随，代码过于易读，整体就显得比较臃肿。

文章插图

在精简与易读之间做权衡，第一种方法根据列表推导式能获得更精简的代码，但第二种方法更易读。
如果说到什么是好代码，我们肯定都能说出一堆规则，例如使用一致的格式和缩进、使用清晰的变量名和方法名、在必要时提供文档与注释、不要过度精简代码等等。
但是对于什么是烂代码，你有比较清晰的认识吗？
在 GitHub 上有一个新项目，它描述了「最佳垃圾代码」的十九条关键准则。从变量命名到注释编写。这些准则将指导你写出最亮眼的烂代码。
为了保持与原 GitHub 项目一致的风格，下文没有进行转换。读者们可以以相反的角度来理解所有观点，这样就能完美避免写出垃圾代码。
项目地址：
https://github.com/trekhleb/state-of-the-art-shitcode
当然，以下十九条垃圾代码书写准则并没有面面俱到，如果读者们发现有一些难以忍受的烂代码习惯，也可以留言发表你的看法。
第一条：打字越少越好
如果我们键入的东西越少，那么就有越多的时间去思考代码逻辑等问题。如下所示，「Good」表示遵循该规则的示例， Bad 表示没遵循该规则的示例。