计算
弹性云服务器 ECS
Flexus云服务
裸金属服务器 BMS
弹性伸缩 AS
镜像服务 IMS
专属主机 DeH
函数工作流 FunctionGraph
云手机服务器 CPH
Huawei Cloud EulerOS
网络
虚拟私有云 VPC
弹性公网IP EIP
虚拟专用网络 VPN
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
VPC终端节点 VPCEP
云连接 CC
企业路由器 ER
企业交换机 ESW
全球加速 GA
安全与合规
安全技术与应用
Web应用防火墙 WAF
企业主机安全 HSS
云防火墙 CFW
安全云脑 SecMaster
DDoS防护 AAD
数据加密服务 DEW
数据库安全服务 DBSS
云堡垒机 CBH
数据安全中心 DSC
云证书管理服务 CCM
边缘安全 EdgeSec
威胁检测服务 MTD
CDN与智能边缘
内容分发网络 CDN
CloudPond云服务
智能边缘云 IEC
迁移
主机迁移服务 SMS
对象存储迁移服务 OMS
云数据迁移 CDM
迁移中心 MGC
大数据
MapReduce服务 MRS
数据湖探索 DLI
表格存储服务 CloudTable
云搜索服务 CSS
数据接入服务 DIS
数据仓库服务 GaussDB(DWS)
数据治理中心 DataArts Studio
数据可视化 DLV
数据湖工厂 DLF
湖仓构建 LakeFormation
企业应用
云桌面 Workspace
应用与数据集成平台 ROMA Connect
云解析服务 DNS
专属云
专属计算集群 DCC
IoT物联网
IoT物联网
设备接入 IoTDA
智能边缘平台 IEF
用户服务
账号中心
费用中心
成本中心
资源中心
企业管理
工单管理
国际站常见问题
ICP备案
我的凭证
支持计划
客户运营能力
合作伙伴支持计划
专业服务
区块链
区块链服务 BCS
Web3节点引擎服务 NES
解决方案
SAP
高性能计算 HPC
视频
视频直播 Live
视频点播 VOD
媒体处理 MPC
实时音视频 SparkRTC
数字内容生产线 MetaStudio
存储
对象存储服务 OBS
云硬盘 EVS
云备份 CBR
存储容灾服务 SDRS
高性能弹性文件服务 SFS Turbo
弹性文件服务 SFS
云硬盘备份 VBS
云服务器备份 CSBS
数据快递服务 DES
专属分布式存储服务 DSS
容器
云容器引擎 CCE
容器镜像服务 SWR
应用服务网格 ASM
华为云UCS
云容器实例 CCI
管理与监管
云监控服务 CES
统一身份认证服务 IAM
资源编排服务 RFS
云审计服务 CTS
标签管理服务 TMS
云日志服务 LTS
配置审计 Config
资源访问管理 RAM
消息通知服务 SMN
应用运维管理 AOM
应用性能管理 APM
组织 Organizations
优化顾问 OA
IAM 身份中心
云运维中心 COC
资源治理中心 RGC
应用身份管理服务 OneAccess
数据库
云数据库 RDS
文档数据库服务 DDS
数据管理服务 DAS
数据复制服务 DRS
云数据库 GeminiDB
云数据库 GaussDB
分布式数据库中间件 DDM
数据库和应用迁移 UGO
云数据库 TaurusDB
人工智能
人脸识别服务 FRS
图引擎服务 GES
图像识别 Image
内容审核 Moderation
文字识别 OCR
AI开发平台ModelArts
图像搜索 ImageSearch
对话机器人服务 CBS
华为HiLens
视频智能分析服务 VIAS
语音交互服务 SIS
应用中间件
分布式缓存服务 DCS
API网关 APIG
微服务引擎 CSE
分布式消息服务Kafka版
分布式消息服务RabbitMQ版
分布式消息服务RocketMQ版
多活高可用服务 MAS
事件网格 EG
企业协同
华为云会议 Meeting
云通信
消息&短信 MSGSMS
云生态
合作伙伴中心
云商店
开发者工具
SDK开发指南
API签名指南
Terraform
华为云命令行工具服务 KooCLI
其他
产品价格详情
系统权限
管理控制台
客户关联华为云合作伙伴须知
消息中心
公共问题
开发与运维
应用管理与运维平台 ServiceStage
软件开发生产线 CodeArts
需求管理 CodeArts Req
部署 CodeArts Deploy
性能测试 CodeArts PerfTest
编译构建 CodeArts Build
流水线 CodeArts Pipeline
制品仓库 CodeArts Artifact
测试计划 CodeArts TestPlan
代码检查 CodeArts Check
代码托管 CodeArts Repo
云应用引擎 CAE
开天aPaaS
云消息服务 KooMessage
云手机服务 KooPhone
云空间服务 KooDrive
本文导读
文档首页/ 代码检查 CodeArts Check/ API参考/ 附录/ Cmetrics工具规格说明

Cmetrics工具规格说明

更新时间:2024-12-02 GMT+08:00

工具介绍

Cmetrics是华为公司自研代码度量工具,通过扫描源码对各项指标进行度量。度量指标包括代码量、函数圈复杂度、文件代码行、函数代码行、文件重复、代码重复、危险函数、冗余代码等多项指标。当前工具版本为2.1.5。

参数说明

表1 参数说明

参数

说明

code_size

代码规模。

统计工程中删除空行和注释行后的代码行数量。

raw_lines

原始代码行数。

统计工程中所有代码文件的物理行总数,包含空行和注释行。

methods_total

函数总数。

统计工程中所有代码文件的方法总个数。其中Java抽象方法的方法声明后不带函数体,不会被识别成函数。

cyclomatic_complexity_total

圈复杂度总数。

统计所有函数圈复杂度数的总和。

method默认圈复杂度为1,每出现特定关键字一次,则圈复杂度加1,出现三目运算符圈复杂度加1。

圈复杂度与cca圈复杂度的区别在于switch语句统计方式:圈复杂度计算时switch里面有几个case,圈复杂度就加几,而cca圈复杂度计算时,无论switch里面有几个case,圈复杂度只加1。

cyclomatic_complexity_per_method

平均圈复杂度。

平均圈复杂度=圈复杂度总数/函数总数

maximum_cyclomatic_complexity

最大圈复杂度。

代码检查任务执行完成后,统计所有函数中圈复杂度最大的值。

huge_cyclomatic_complexity_total

超大圈复杂度函数总数。

统计圈复杂度大于阈值的函数个数。其中阈值由Cmetrics工具版本决定,详情可参考表2;部分语言可通过Cmetrics规则修改。

huge_cyclomatic_complexity_ratio

超大圈复杂度比例。

超大圈复杂度比例=超大圈复杂度数/函数总数*100(单位:百分比%)

cca_cyclomatic_complexity_total

cca圈复杂度总数。

统计所有函数cca圈复杂度数的总和。

method默认圈复杂度为1,每出现特定关键字一次,则圈复杂度加1,出现三目运算符圈复杂度加1。

圈复杂度与cca圈复杂度的区别在于switch语句统计方式:圈复杂度计算时switch里面有几个case,圈复杂度就加几,而cca圈复杂度计算时,无论switch里面有几个case,圈复杂度只加1。

cca_cyclomatic_complexity_per_method

cca平均圈复杂度。

cca平均圈复杂度=cca圈复杂度总数/函数总数

maximum_cca_cyclomatic_complexity

cca最大圈复杂度。

代码检查任务执行完成后,统计所有函数中cca圈复杂度最大的值。

huge_cca_cyclomatic_complexity_total

超大cca圈复杂度函数总数。

统计cca圈复杂度大于阈值的函数个数。其中阈值由Cmetrics工具版本决定,部分语言可通过Cmetrics规则修改。

cyclomatic_complexity_adequacy

圈复杂度满足度。

圈复杂度满足度=((函数总数-超大cca圈复杂度函数总数) / 函数总数)*100(单位:百分比%)

cyclomatic complexity adequacy的缩写即为cca。

maximum_depth

最大深度。

代码检查任务执行完成后,统计所有函数中深度最大的值。

huge_depth_total

超大深度数。

统计最大深度大于阈值的函数个数。其中阈值由Cmetrics工具版本决定,详情可参考表2;部分语言可通过Cmetrics规则修改。

huge_depth_ratio

超大深度占比。

超大深度占比=超大深度数/函数总数(单位:百分比%)

method_lines

函数总行数。

统计所有函数的非空非注释行代码行总和。

注意:在去掉空行注释行以后,统计函数内部代码块的行数,函数开头定义行不统计在内。

lines_per_method

函数平均代码行。

函数平均代码行=函数总行数/函数总数

huge_method_total

超大函数数。

函数代码行大于阈值的函数个数。其中阈值由Cmetrics工具版本决定,详情可参考表2;部分语言可通过Cmetrics规则修改。

huge_method_ratio

超大函数占比。

超大函数占比=超大函数数/函数总数*100(单位:百分比%)

files_total

文件总数。

扫描工程目录中符合源码文件后缀名的文件总个数,其中空文件不会统计在内。不同语言对应的文件后缀可参考表3

folders_total

目录总数。

工程里目录的总个数。其中空目录不会被计算在内。

lines_per_file

文件平均代码行。

文件平均代码行=代码行总数/文件总数

huge_headerfile_total

超大头文件数。

C语言源码文件中后缀名为“.h”“.hh”“.hpp”“.hxx”“.h++”“.inc”“.inl”的被认为是头文件,其中有效代码行大于阈值的认为是超大头文件。其中阈值由Cmetrics工具版本决定,详情可参考表2

huge_headerfile_ratio

超大头文件占比。

超大头文件占比=超大头文件数/文件总数*100(单位:百分比%)

huge_non_headerfile_total

超大源文件数。

源码文件中后缀名不为头文件,并且有效代码行大于阈值的认为是超大源文件。其中阈值由Cmetrics工具版本决定,详情可参考表2;部分语言可通过Cmetrics规则修改。

huge_non_headerfile_ratio

超大源文件占比。

超大源文件占比=超大源文件数/文件总数*100(单位:百分比%)

huge_folder_total

超大目录数。

统计某目录内的文件和子目录总数(不计算该目录节点下子目录下更深层次的子目录数和文件数),当总数大于阈值时,则判断为超大目录。空子目录(子目录里面没有源码文件的)不计算在内。其中阈值由Cmetrics工具版本决定,详情可参考表2;部分语言可通过Cmetrics规则修改。

huge_folder_ratio

超大目录占比。

超大目录占比=超大目录数/目录总数*100(单位:百分比%)

file_duplication_total

重复文件数。

统计文件内容完全相同的文件个数。仅统计后缀名符合各语言源码文件后缀名的文件,不同语言对应的文件后缀可参考表3

file_duplication_ratio

文件重复率。

文件重复率=重复文件数/文件总数*100(单位:百分比%)

non_hfile_duplication_total

重复源文件数。

统计C语言重复文件中后缀名为源文件的文件个数。其他语言没有头文件,所有文件都是源文件。

non_hfile_duplication_ratio

源文件重复率。

源文件重复率=重复源文件数/文件总数*100(单位:百分比%)

code_duplication_total

代码重复数。

非空非注释行连续10行相同的代码片段和import行(第三方机构标准),会被识别是重复代码。

说明:

代码重复数是过每个文件的重复代码行相加得出,而不是以重复代码明细结果里的代码片段相加。如:三个文件都有相同的10行重复代码,则代码重复数为30;如:A文件1~10行与B文件重复,A文件2~11行与C文件重复,则取代码片段并集的行数,A文件重复代码行为11行。

code_duplication_ratio

代码重复率。

代码重复率=代码重复数/代码行总数*100(单位:百分比%)

non_hfile_code_duplication_total

源文件代码重复数。

源文件的代码重复行数总数。即只统计后缀名符合源代码文件(C/C++语言不包含头文件)要求的文件的重复代码行。

non_hfile_code_duplication_ratio

源文件代码重复率。

源文件代码重复率=源文件代码重复数/代码行总数(单位:百分比%)

unsafe_functions_total

危险函数总数。

统计代码中出现调用不安全函数,如memcpy、memmove等函数的调用次数。

说明:

目前clike检查不安全函数,其他语言不检查该指标。

unsafe_functions_kloc

危险函数密度(每千行代码中包含的危险函数个数)。

危险函数密度=危险函数总数/代码行总数*1000

redundant_code_total

冗余代码数。

统计注释中冗余代码块的个数。注释中的代码被视作冗余代码;注释中包含编程语言关键字的或符合语法规则的连续单词组会被判断为冗余代码。

其中块注释有多行冗余代码,只算一次冗余代码数。

redundant_code_kloc

冗余代码块密度(每千行代码中包含的冗余代码数)。

冗余代码块密度=冗余代码数/代码行总数*1000

说明:

如果代码行总数少于1000,不计算密度,取值为0。

warning_suppression_total

抑制告警数。

统计被扫描文件的告警抑制语句出现的数量。注释中的字符串符合特定正则表达式,则会被认为是告警抑制语句。不同语言对应的正则表达式请参考表5

该参数需启用Cmetrics规则后生效。

warning_suppression_kloc

抑制告警密度。

抑制告警密度=抑制告警数/代码行总数*1000(每千行代码中包含的冗余代码数)

该参数需启用Cmetrics规则后生效。

表2 Cmetrics工具默认阈值

阈值名称

默认值

超大圈复杂度函数-圈复杂度阈值

20

超大深度数函数-深度阈值

4

超大函数-行数阈值

50

超大头文件-行数阈值

500

超大源文件-行数阈值

2000

超大目录数-节点阈值

50

表3 Cmetrics工具编程语言与文件扩展名关联关系

语言

后缀

JAVA

.java

C/C++

.c/.cc/.cpp/.cxx/.cp/.c++/.inc/.inl/.mm/.h/.hh/.hpp/.hxx/.h++

TYPESCRIPT

.ts/.tsx

RUST

.rs

ARKTS

.ets

C#

.cs

GO

.go

JAVASCRIPT

.js/.jsx

LUA

.lua

PYTHON

.py

表4 Cmetrics工具支持检查C/C++的危险函数列表

_fstrncat

_vsntprintf

strcatbuff

vos_nsprintf

_fstrncpy

_vsnwprintf

strcatbuffa

vos_nvsprintf

_ftcscat

_vstprintf

strcatbuffw

vos_snprintf

_ftcscpy

bcopy

strcatchainw

vos_sprintf

_getts

copymemory

strcatn

vos_sscanf

_gettws

fscanf

strcatna

vos_strcat

_getws

fwscanf

strcatnw

vos_strcpy

_mbccat

gets

strcatw

vos_strncat

_mbccpy

lstrcat

strcpy

vos_strncpy

_mbscat

lstrcata

strcpya

vos_vsprintf

_mbscpy

lstrcatn

strcpyn

vos_vsscanf

_mbsnbcat

lstrcatnA

strcpyna

vscanf

_mbsnbcpy

lstrcatnW

strcpynw

vsnprintf

_mbsncat

lstrcatw

strcpyw

vsprintf

_mbsncpy

lstrcpy

strncat

vsscanf

_snprintf

lstrcpya

strncata

vswprintf

_sntprintf

lstrcpyn

strncatw

vswscanf

_sntscanf

lstrcpyna

strncpy

vwscanf

_snwprintf

lstrcpynw

strncpya

wcscat

_stprintf

lstrcpyw

strncpyw

wcscpy

_stscanf

lstrncat

swprintf

wcsncat

_tccat

memcpy

swscanf

wcsncpy

_tccpy

memmove

vfscanf

wmemcpy

_tcscat

memset

vfwscanf

wmemmove

_tcscpy

nsprintf

vos_chkmemcpy

wnsprintf

_tcsncat

rtlcopymemory

vos_chkmemmove

wnsprintfA

_tcsncpy

scanf

vos_chkmemset

wnsprintfW

_tscanf

snprintf

vos_chkstrcat

wscanf

_vos_bzero

snscanf

vos_chkstrcpy

wsprintf

_vos_memcpy

sntprintf

vos_chkstrncat

wsprintfa

_vos_memmove

snwscanf

vos_chkstrncpy

wsprintfw

_vos_memset

sprintf

vos_mem_copy

wvnsprintf

_vos_strcat

sprintfa

vos_mem_set

wvnsprintfa

_vos_strcpy

sprintfw

vos_mem_zero

wvnsprintfw

_vos_strncat

sscanf

vos_memcpy

wvsprintf

_vos_strncpy

strcat

vos_memmove

wvsprintfa

_vsnprintf

strcata

vos_memset

wvsprintfw

表5 Cmetrics工具告警抑制规则

语言类型

注释匹配正则表达式

C/C++、JAVA、JAVASCRIPT、TYPESCRIPT

  • r'(/(\*|/)\s*(lint\b\s+\S+|coverity\s*\[.+?\]|eslint-disable)'
  • r'|^\s*#\s*pragma\s+\w+\s+diagnostic\s+(ignored|warning)'
  • r'|^\s*#\s*pragma\s+warning\s*\(\s*disable'
  • r'|^\s*@(\w+\.)?SuppressWarnings)'

PYTHON

r'#\s*pylint\s*:'

我们使用cookie来确保您的高速浏览体验。继续浏览本站,即表示您同意我们使用cookie。 详情

文档反馈

文档反馈

意见反馈

0/500

标记内容

同时提交标记内容