SonarQube怎么查看认知复杂度 SonarQube认知复杂度过高如何定位具体代码

SonarQube中的Cognitive Complexity用于衡量代码控制流程的理解难度，与Cyclomatic Complexity侧重统计执行路径不同。项目中的认知复杂度可以在Measures中查看，并逐步下钻到目录和文件；如果要继续定位具体函数，则需要结合认知复杂度规则产生的Issue进行检查。项目指标很高却找不到对应Issue时，还要区分“累计指标”和“单个函数规则阈值”这两种计算结果。

一、SonarQube怎么查看认知复杂度

SonarQube完成代码分析后会生成【Cognitive Complexity】指标，指标键为【cognitive_complexity】。可以先查看项目整体数值，再通过文件层级找到复杂度主要集中在哪些模块。

1、在Measures中查看复杂度

①登录SonarQube并打开目标项目。

②进入项目顶部的【Measures】。

③找到【Complexity】分类。

④选择【Cognitive Complexity】。

⑤查看当前项目的整体数值。

⑥切换到文件或目录视图。

⑦逐层展开代码目录。

⑧记录Cognitive Complexity数值较高的文件。

同时还能看到【Complexity】，这一项对应Cyclomatic Complexity。两种指标计算方式不同，排查认知复杂度时不要把两个数值直接作为同一指标比较。

2、查看某个文件的认知复杂度

①在【Measures】中选择【Cognitive Complexity】。

②进入目录列表。

③点击复杂度较高的目录。

④继续进入具体源文件。

⑤记录文件当前的Cognitive Complexity。

⑥比较同一模块中的其他文件。

⑦优先记录明显高于同类文件的对象。

文件级Cognitive Complexity是文件中相关代码复杂度的累计结果，因此文件数值为60，并不表示其中一定存在一个复杂度为60的函数。

3、查看复杂度变化时间

①进入项目【Activity】。

②打开指标图表。

③选择【Custom】。

④点击【Add metric】。

⑤添加【Cognitive Complexity】。

⑥查看各次代码分析后的数值。

⑦找到复杂度明显增长的分析时间点。

⑧结合对应版本或提交范围检查新增代码。

这种方式适合项目整体复杂度突然增加的情况，可以先锁定变化版本，再缩小文件检查范围。

二、SonarQube认知复杂度过高如何定位具体代码

真正定位到函数或方法时，可以通过Issues查找对应的认知复杂度规则。SonarQube会在单个函数超过规则允许阈值后创建Issue，并给出文件和代码位置。

1、按认知复杂度规则筛选Issue

①打开目标项目。

②进入【Issues】。

③在左侧筛选区域找到【Rule】。

④搜索【Cognitive Complexity】。

⑤选择【Cognitive Complexity of functions should not be too high】或当前语言对应的方法复杂度规则。

⑥查看筛选后的Issue列表。

⑦按照文件路径找到目标代码。

⑧点击Issue进入详细信息。

⑨定位SonarQube标记的函数或方法。

不少语言使用的认知复杂度规则编号为【S3776】，但规则参数和默认阈值会随语言存在差异，所以实际检查时以当前项目使用的语言规则为准。

2、查看具体函数为什么超限

①打开认知复杂度Issue。

②查看Issue提示的当前复杂度值。

③同时确认规则要求的最大值。

④进入对应源文件。

⑤找到被标记的方法或函数。

⑥检查SonarQube标出的相关代码位置。

⑦重点查看连续嵌套的【if】【for】【while】等控制结构。

⑧继续检查异常处理、递归和流程跳转。

⑨记录嵌套最深的几段逻辑。

Cognitive Complexity会对打断顺序阅读的控制结构增加复杂度，并对嵌套进一步增加权重，因此一个五层嵌套的判断通常比多个平级判断更容易触发规则。

3、项目指标很高却没有复杂度Issue

①进入【Quality Profiles】。

②选择当前项目语言使用的Profile。

③搜索【Cognitive Complexity】。

④确认对应规则已经【Active】。

⑤打开规则查看【threshold】。

⑥确认当前阈值没有被设置得过高。

⑦返回项目【Issues】。

⑧清除【New Code】【Status】等额外筛选条件。

⑨重新搜索认知复杂度规则。

Measures中的Cognitive Complexity是累计Metric，而S3776一类规则检查的是单个函数或方法。项目累计复杂度可以很高，但如果所有函数都低于阈值，就不会产生复杂度Issue。

三、定位到高复杂度代码后怎么继续处理

找到具体函数后，重点不是机械减少SonarQube显示的数字，而是确认哪些控制流程让代码阅读时需要同时记住过多上下文，再针对这些位置调整结构。

1、优先检查深层嵌套

①查看连续出现的【if】和【else】。

②检查循环内部是否继续嵌套条件判断。

③查看【try】【catch】内部是否还有复杂分支。

④检查一个方法是否同时承担多段独立业务逻辑。

⑤可以提前结束的异常条件改用提前返回。

⑥能够独立表达含义的代码抽取成单独方法。

⑦保存后重新运行代码分析。

减少嵌套通常比单纯缩短函数行数更容易降低认知复杂度。

2、检查复杂条件表达式

①找到包含多个逻辑运算的条件。

②确认条件中是否同时处理多个业务判断。

③把含义独立的判断拆成命名明确的方法或变量。

④检查长【if-else】链是否能够调整结构。

⑤重新检查控制流程是否更容易顺序阅读。

3、重新分析验证修改结果

①提交修改后的代码。

②重新执行SonarScanner。

③打开【Issues】。

④找到原来的认知复杂度Issue。

⑤确认问题是否已经关闭。

⑥进入【Measures】重新查看【Cognitive Complexity】。

⑦比较对应文件修改前后的数值。

⑧再检查是否还有其他高复杂度函数需要处理。

总结

SonarQube查看认知复杂度时，可以先在Measures中查看项目、目录和文件层面的Cognitive Complexity，再通过Issues中的认知复杂度规则定位具体函数或方法。项目复杂度很高却没有Issue时，应继续检查Quality Profile中的规则状态和threshold，因为累计指标与单函数阈值并不是同一种判断方式。找到具体代码后，再从深层嵌套、复杂条件和过长控制流程入手调整，更容易降低代码理解成本。如需进一步了解SonarQube认知复杂度查看、复杂函数定位与代码复杂度分析方法，欢迎联系咨询。