Complejidad ciclomática total

Actualizado el 15 de noviembre de 2026

Sigla v(G)tot
Aspecto «Complejidad»
Se mide en paquete, módulo, proyecto
Tipo de valor recuento (entero, mínimo 0)
Dirección informativa: ni alto ni bajo es mejor
Familia «Métricas de McCabe»
Stau Metro TotalCyclomaticComplexityPackage, TotalCyclomaticComplexityModule, TotalCyclomaticComplexityProject

En pocas palabras

Suma la complejidad ciclomática de todos los métodos de un paquete, un módulo o el proyecto. Es una medida de cuánta lógica de decisión hay en esa parte del código, en total. Crece con el tamaño, así que no es ni buena ni mala por sí misma.

Qué mide

El volumen de lógica de decisión. Si cada punto de v(G) es, aproximadamente, un caso más que probar, la suma da una idea del esfuerzo de prueba que representa una parte del código. Es la versión agregada de lo que la «complejidad ponderada de los métodos» (WMC) es para una clase.

No tiene dirección: un módulo grande tiene un total alto porque hace muchas cosas, no porque esté mal hecho. Sirve para comparar, para priorizar y para ver tendencias.

Cómo se calcula

Con v(Gi)v(G_i) la «complejidad ciclomática» de cada método:

v(G)tot=∑i=1nv(Gi)v(G)_{tot} = \sum_{i=1}^{n} v(G_i)

Como cada método vale al menos 1, el total es siempre mayor o igual que el número de métodos, y la diferencia v(G)tot−nv(G)_{tot} - n es el número de decisiones de toda esa parte del código.

Ejemplo

Un paquete con tres métodos de complejidad 1, 4 y 7 tiene v(G)tot = 1 + 4 + 7 = 12, y 12 - 3 = 9 decisiones. Su «complejidad ciclomática promedio» es 12 / 3 = 4.0.

Cómo interpretarla

Stau Metro no le da umbral de referencia, y no tendría sentido: el valor depende del tamaño.

  • Priorizar. Entre varios paquetes o módulos, el de mayor total es donde más lógica hay que mantener y probar. Es un buen punto de partida para revisar la «cobertura de código».
  • Dividir el total por el tamaño. Junto a la media (v(G)avg) dice si el total viene de muchos métodos sencillos o de métodos complejos; junto a las «líneas de código sin comentarios» (NCLOC), da la densidad de decisiones por línea.
  • Seguir la evolución. Un total que crece más deprisa que las líneas de código indica que el código nuevo es más condicional que el existente.

Relación con otras métricas

En las herramientas

Stau Metro (TotalCyclomaticComplexityPackage, TotalCyclomaticComplexityModule y TotalCyclomaticComplexityProject). Suma la v(G) de los métodos con el mismo recuento y el mismo alcance que la métrica de método CyclomaticComplexity:

  • entran todos los métodos no abstractos de los ficheros Java analizados, incluidos los constructores, los métodos default, static y privados de las interfaces, y el código de test; un método native suma 1;
  • los métodos de las clases anónimas o locales declaradas dentro de un método no cuentan aparte: sus decisiones se suman al método que las contiene; los de las clases anónimas de un inicializador de campo y de los cuerpos de las constantes de un enumerado sí cuentan;
  • a nivel de paquete entran solo las clases del propio paquete, no las de sus subpaquetes;
  • un paquete o un módulo tiene valor desde su primer método contado; el proyecto tiene siempre su fila.

SonarQube. La complejidad ciclomática (complexity) del conjunto del código es, según su documentación, «básicamente la suma» de las calculadas a nivel de función. Las reglas de recuento por función son las suyas (ver la página de la «complejidad ciclomática»).

Referencias