认知复杂度(Cognitive Complexity)是一种衡量代码可理解性和维护成本的指标,由 SonarQube 提出。与传统的圈复杂度(Cyclomatic Complexity)不同,它更关注代码阅读时的认知负担,而非单纯的控制流路径数量。以下是其核心计算方法与规则:
一、计算核心规则
忽略简写(Shorthand Ignored)
语法糖(如空合并运算符、链式调用)不会增加复杂度,因为它们简化了代码逻辑。例如,return a ?? b 的复杂度等同于 if (a != null) return a else return b,但前者不计入复杂度增量。
中断线性流程的结构(Linear Flow Breaks)
以下结构每次出现会增加 1 分:
条件语句(if/else if/switch)
循环(for/while/do-while)
异常处理(try/catch)
逻辑运算符序列(如 &&、|| 的连续使用)。
嵌套结构(Nesting)
每层嵌套(如 if 内部嵌套 for)额外增加 1 分。例如:
if (conditionA) { // +1
for (item : list) { // +1(循环本身) +1(嵌套于if)
// ...
}
}
此段代码的认知复杂度为 3。
递归与跳转(Recursion & Jumps)
递归调用(直接或间接)每次增加 1 分,break/continue 等跳转语句也会增加复杂度。