认知复杂度(Cognitive Complexity)

认知复杂度(Cognitive Complexity)是一种衡量代码被人类理解难度的度量指标,由静态分析公司 SonarSource 的安·坎贝尔(G. Ann Campbell)于 2016 年在白皮书中提出,并在 SonarQube 等工具中落地。它的目标是修正沿用数十年的圈复杂度在评估可读性上的失真。

概述

圈复杂度诞生于 1976 年,度量的是控制流图中线性独立路径的数量,适合估算测试用例数量,但并不贴合人的阅读体验:一个由十个连续 case 组成的 switch 语句圈复杂度很高,读起来却一目了然;而一段三层嵌套的循环加条件,圈复杂度可能不高,理解成本却极大。认知复杂度针对这一点重新设计计分规则,让分数与开发者的直观感受一致,从而更适合作为可维护性门禁。

核心原理

• 中断线性流程才计分:if、循环、catch、三元表达式等打断自上而下阅读的结构各计一分;而把多个条件写成方法调用等不打断阅读的写法不额外计分。
• 嵌套加罚:每深一层嵌套,内部结构的计分额外加一,鼓励用卫语句、提前返回和提取函数来压平嵌套。
• 速记结构优惠:switch 整体只计一分,连续同类逻辑运算符只计一次,符合人脑把它们当作整体的习惯。

应用场景

认知复杂度主要用于代码评审辅助与质量门禁:SonarQube 默认对超过阈值(常见为 15)的函数发出告警,提示拆分或简化。它也常被用作重构优先级的依据——优先处理认知复杂度高且改动频繁的热点函数,投入产出比最高。

常见问题

问:认知复杂度会取代圈复杂度吗？答:不会,两者用途不同。圈复杂度仍适合指导测试覆盖(路径数),认知复杂度适合衡量可读性与维护成本,成熟团队通常同时参考。

问:分数多少算合格？答:没有绝对标准。SonarQube 默认函数级阈值为 15,许多团队对新代码收紧到 10 以内;关键是对超标函数强制评审,而非机械追求零分。