SuperAPI AI 工具集

find-complexity

通用与其它

查看项目

更新于 10-16 03:11

技能介绍

用途:在 Go 代码库中查找复杂度热点,报告难以审查、测试和维护的函数,但不执行重构。

主要能力:

  • 圈复杂度(gocyclo,阈值超过 10):1-10 简单,11-20 中等,21-50 复杂,51+ 不可测试。
  • 认知复杂度(gocognit,阈值超过 15),会按嵌套深度加权。
  • 函数长度:超过 50 行(不含注释和空行)。
  • 参数数量:6 个及以上。
  • 文件大小:超过 500 行。

使用方式: 先确定范围。分支模式只检查相对 main 变更的文件,可使用: git diff --name-only upstream/main -- 'internal/' 'api/' 'cmd/' | grep '.go$' | grep -v '_test.go$' 全量模式扫描整个代码库。 按需安装依赖: go install github.com/fzipp/gocyclo/cmd/gocyclo@latest go install github.com/uudashr/gocognit/cmd/gocognit@latest 运行检查: gocyclo -over 10 <target> gocognit -over 15 <target> 并用文中提供的 awk、rg、wc -l 等命令检查长度、参数与文件规模。

分类与报告:按拆分、简化、参数化、监控、拆分文件归类,报告文件、函数名、行号、复杂度分数、代码行数或参数数量、分类与简要建议,并汇总热点总数、最严重前 5 项及预计重构工作量。

限制:只报告问题,不重构;聚焦生产代码的 internal/、api/、cmd/,默认跳过测试;对结果按严重程度从高到低排序。