我心中理想的代码
软件开发是一个需要团队协作、长期维护的过程,代码整洁是软件长期稳定和可扩展的基础。整洁的代码具备清晰的代码结构和规范的命名,具有良好的可读性和可维护性,便于快速定位和修复问题,有利于新功能的快速迭代。团队成员也可以更高效地协作,减少沟通成本,整体提高项目的研发效率。首先我们可以来看下C++之父Bjarne Stroustrup对于好代码的定义。
我喜欢我的代码优雅且高效。 逻辑应该简单明了,这样 bug 就很难隐藏;依赖关系最小化,以便于维护;错误处理应该根据明确的策略完成;性能应该接近最佳,以免诱使人们通过无原则的优化使代码变得混乱。 干净的代码可以很好地完成一件事。
总体来说,优雅的代码具备如下特点:
阅读上赏心悦目,修改上得心应手。
代码简洁明了,尽量减少冗余和复杂性。
模块化,高内聚低耦合,便于维护和扩展。
可测试性,需要有UT、E2E保证代码的可修改性。
适当的注释和文档,解释代码的意图和实现细节。
现实中的代码
圈复杂度
圈复杂度(Cyclomatic Complexity)是一种代码复杂度的度量指标,用于衡量代码中的控制流路径的数量和复杂程度。它通过统计代码中的决策点(如条件语句和循环语句)来计算。圈复杂度的值可以用于判断代码的复杂程度和测试的覆盖范围。较高的圈复杂度表示代码中存在更多的路径和可能的执行情况,增加了理解、维护和测试代码的难度。
iLogtail代码复杂度探讨
iLogtail 作为一款阿里云日志服务(SLS)团队自研的可观测数据采集器,目前已经在 Github 开源,其核心定位是帮助开发者构建统一的数据采集层。不仅仅是在功能、性能上表现突出,代码层面也一直在追求整洁优雅,详见《跟着iLogtail学习设计模式》。
iLogtail部分关键模块代码,代码行数跟圈复杂度基本是控制在比较合理的范畴。
但是也存在少数代码,整体复杂度已经到了极度复杂的程度,严重影响了代码的可扩展性。例如,下图两个函数,563行代码/169圈复杂度 代码[1], 332行代码/71圈复杂度 代码[2]。