知识卡片

普通读书笔记卡 · 1938.d

规模与复杂度的阈值

理解等级:中级

开发者大部分时间在读代码,复杂代码让阅读更困难,所以用复杂度阈值避免过于复杂的代码。大多数规模和复杂度阈值是软阈值,总会有正当例外,只要确保例外不失控。

  • 代码行数(LOC):只计包含实际代码的行,跳过空行和注释;总行数包含一切;统计注释行时应排除文件开头只有版权信息的头部注释。5000 行的文件本身就很复杂——源文件建议限制在约 800 行,再大就考虑拆分;
  • 语句数量:衡量函数/方法规模的好指标,建议阈值每个函数/方法 100 条语句;
  • 圈复杂度(McCabe,1976):通过方法的不同执行路径数,也是达到 100% 测试覆盖所需的最少用例数;简便算法:从 1 开始,每个循环或条件语句加 1,switch 按 case 数加。研究表明超过 24 时错误率迅速上升,保险起见阈值设 15。变体:改进圈复杂度每个 switch 只加 1(switch 推高数值却未真正增加复杂性);扩展圈复杂度还为每个 &&、|| 加 1(短路求值相当于额外条件)。聚合到类、包、模块时用按语句数加权的平均圈复杂度,避免大量 getter/setter 稀释长方法的复杂度;
  • 缩进债务:函数中的最大缩进级别,越深越复杂,非常适合发现复杂代码;同样可按语句数加权聚合到类或文件;建议最大缩进阈值为 4。
这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    参考来源

    - 位置:《软件架构指标:度量软件系统的性能和架构质量》第09章《第9章 使用软件度量指标来确保可维护性》9.4.2 度量代码规模和复杂性(源文件:extracted/软件架构指标 度量软件系统的性能和架构质量/_epub-src/index_split_078.html,来源项目 book-sources) - 结论依据:第9章给出规模与复杂度指标及软阈值:源文件约800行、每个方法100条语句、圈复杂度15(超过24错误率迅速上升,并介绍改进与扩展圈复杂度及按语句数加权平均)、最大缩进4级,并说明统计代码行时应排除版权头注释。 - 原始内容:这个指标经过了广泛的研究,我们知道当其超过24时,错误率会迅速增加。