【.com快者】在金融行业，可理解性是指信息应该以一种读者可以快速、轻松地理解的方式呈现的概念。为了易于理解，财务系统必须完整、简明、清晰和有条理。需要将可理解性的概念引入软件世界。我们已经看到微服务、云和分布式系统的兴起都增加了现代系统的复杂性。这意味着我们的开发团队必须更加努力地工作，以高效地构建可以由越来越多的开发人员轻松维护的应用程序。我们如何编写代码？可理解性始于我们编写代码的方式。作为开发人员，有必要花时间进行重构，以确保我们编写的代码易于被我们的同事理解，同时也能被最终在下个月、明年甚至十年后调试我们的代码的程序员所理解。除此之外，仅当内联评论和外部文档完整、简洁、清晰且有条理时，变更请求才应获得批准。完整：包含开发人员理解组件预期行为所需的所有信息。简洁：以易于扫描的方式编写，以找到重要的内容，而不会过于繁琐或重复；以包含相关信息而不是其他太多信息的方式编写。清晰：格式和介质易于扫描。在软件开发领域，这通常转化为内联评论和wiki页面。有条理：以一种便于读者交叉引用信息的方式呈现信息。维护良好的wiki页面或与IntelliSense工具或源代码控制管理工具的集成在这方面通常是有效的。花时间在文档和评论上似乎会减慢功能的开发速度。但正如有人曾经说过的，如果你有六个小时来砍一棵树，那么明智的做法是用前四个小时来磨斧头。前期工作将使我们的应用程序在未来更容易调试和维护。因为如果应用程序出现故障且难以支持，移交过程将变得过于耗时且效率低下，我们最终将花费整个迭代开发周期（冲刺）来改进文档、单元测试、日志记录等。在微服务和复杂的世界中在分布式系统中，开发人员阅读代码的时间是编写代码的10倍，因此编写干净且易于展示给其他人的代码极为重要。即使您在部署后编写了干净、文档齐全的代码，但在云和分布式系统的世界中，仍然很难预测该代码在部署后的行为方式。干净的代码就像一份详细的烹饪食谱：它清楚地说明了应该做什么，你在准备饭菜时经常会参考食谱，但食谱可能不知道烤箱的当前温度或你如何混合配料.为了让我们的应用程序真正易于理解，我们必须能够实时观察代码。日志记录、跟踪、分析、错误跟踪和分析等工具可以告诉我们代码在应用程序运行时的实际行为。这与首先??编写干净的代码一样重要，因为虽然阅读静态代码对于理解应用程序至关重要，但我们也知道它永远无法完全代表应用程序在生产中的实际行为。一个很好的例子就是配置。如果您的代码有大量基于配置的切换情况，只需阅读代码就可以了解可能发生的情况。要了解实际发生的情况，您必须了解运行时使用的配置。还要记住，归根结底，目的不仅仅是观察系统，而是要达到我们真正理解系统的阶段。这意味着我们需要能够集成到开发环境中的工具，在正在编写的代码的上下文中检索数据，并向下钻取并动态查看代码在现实世界中的行为方式。大多数公司还没有达到成功的另一面。如果你有观察力，你已经领先于大多数公司。但是一旦发现问题，仍然需要进行额外的工作才能真正深入了解应用程序中发生的情况。一个很好的例子是生产级调试器，解决可理解性问题的工具；我希望在接下来的几个月里看到越来越多的关于这些工具的讨论。原标题：编写整洁代码的重要性，作者：LiranHaimovitch
