就开发而言,我们知道编写代码不是一个人的事情,因此,作为开发人员,有必要花时间进行重构,以确保我们编写的代码易于被同事理解,还要易于被最终在下个月、下一年甚至多年后调试我们代码的程序员理解。
那么应该如何编写代码呢?
1.完整:含有开发人员理解某个组件的预期行为所需要的所有信息。
2.简洁:以一种易于扫描以查找重点内容,且不太麻烦或重复的方式来加以编写;以一种含有相关信息,没有太多其他信息的方式来加以编写。
3.清晰:格式和介质易于扫描。在软件开发界,这通常转化为内联注释和维基页面。
4.有条理:以一种使读者易于相互对照信息的方式呈现信息。精心维护的维基页面或者与IntelliSense工具或源代码控制管理工具集成通常在这方面很有效。
文档和注释上花点时间似乎会减慢某项功能的开发。但正如有人曾说过,如果您有六小时的时间来砍树,花前四个时间来磨斧头是明智的。前期工作将使我们的应用程序将来调试和维护起来要容易得多。因为如果应用程序变得错误过多,太难支持,交接过程变得太耗时、效率低下,我们到头来会把整个迭代开发周期(sprint)耗费在改进文档、单元测试和日志记录等方面上。
在微服务和分布式系统这个复杂的世界,开发人员花在阅读代码上的时间要比花在编写代码上的时间多10倍,因此我们编写的代码干净、很容易展示给他人来得无比重要。
部署代码后
即使您编写了干净、文档完备的代码,在云和分布式系统世界,仍然很难预测该代码在部署后会有怎样的行为。为了使我们的应用程序真正易于理解,我们必须能够实时观察代码。日志记录、跟踪、监测、错误跟踪和性能分析之类的工具可以告诉我们代码在运行时应用程序的实际行为。这与一开始编写干净的代码一样重要。
还要记住,到头来目的是不仅限于观察系统,而是进入到我们真正了解系统的阶段。这意味着我们需要集成到开发环境中的工具、在所编写代码的上下文中检索数据的工具以及深入动态地查看代码在实际环境下如何运行的工具。
以上就是编写干净整洁代码的重要性以及编写要求,希望以上内容对你有所帮助。