τTau SolutionsPara empezar

Rutas de lectura

Actualizado el 15 de noviembre de 2026

La referencia se puede leer por aspecto o por familia, pero casi nadie llega a ella con un aspecto en mente: llega con una decisión que tomar. Cada ruta de esta página es una lista ordenada de páginas para una decisión concreta, con una línea que dice qué aporta cada una. Si es tu primera vez, lee antes «cómo leer una métrica» y «las métricas esenciales».

Revisar un cambio

Para una revisión de código: qué mirar en los métodos y clases que el cambio añade o modifica.

  1. «Complejidad cognitiva» (CogC): si el método nuevo se sigue sin esfuerzo al leerlo, que es lo que hace quien revisa.
  2. «Complejidad ciclomática» (v(G)): cuántos caminos añade el cambio y, por tanto, cuántos casos deberían tener test.
  3. «Profundidad de anidamiento» (NBD): el síntoma más fácil de corregir en la propia revisión, con una cláusula de guarda o un método extraído.
  4. «Líneas de código sin comentarios» (NCLOC) y «número de parámetros» (NP): un método que crece o una firma que se alarga en cada cambio.
  5. «Número de dependencias» (Dcy): si la clase ha empezado a usar clases que antes no conocía.
  6. «Número de dependencias cíclicas» (Cyclic): un cambio pequeño puede cerrar un ciclo entre paquetes; es más barato verlo ahora que deshacerlo después.
  7. «Número de veces invocado» (CALLED): a cuántos sitios llega un cambio de comportamiento en un método existente.
  8. «Acoplamiento de cambio»: si los ficheros que suelen cambiar junto a los modificados no aparecen en el cambio, puede estar incompleto.

Buscar candidatos a refactorizar

Para decidir qué mejorar cuando no se puede mejorar todo.

  1. «Puntos calientes de cambio»: cruzan complejidad y frecuencia de cambio; la lista de partida más útil.
  2. «Complejidad ponderada de los métodos» (WMC): las clases que reúnen más lógica.
  3. «Complejidad máxima de las operaciones» (OCmax): dentro de esas clases, si el problema es un método o la clase entera.
  4. «Falta de cohesión de los métodos» (LCOM): por dónde partir una clase que hace varias cosas.
  5. «Acoplamiento entre objetos» (CBO) y «respuesta para la clase» (RFC): las clases que saben demasiado de las demás.
  6. «Densidad de líneas duplicadas»: el código copiado, donde un mismo arreglo hay que hacerlo varias veces.
  7. «Número de veces invocado en código de producción» (CALLEDp): un método al que solo llaman sus tests puede ser código muerto, y lo mejor es borrarlo.
  8. «Lanza y Marinescu: estrategias de detección»: cómo combinar varias métricas con umbrales para detectar problemas de diseño con nombre propio.

Valorar una arquitectura

Para juzgar cómo está dividido un sistema en paquetes y módulos, y si esa división se sostiene.

  1. «Guía del aspecto: diseño de paquetes»: el marco de las métricas que siguen.
  2. «Número de dependencias cíclicas» (Cyclic) de paquete: lo primero que hay que descartar, porque un ciclo convierte varios paquetes en una sola pieza.
  3. «Orden de nivel» (Level) y su «variante ajustada» (Level*): cuántas capas hay de verdad, y si los ciclos esconden pisos.
  4. «Acoplamientos aferentes» (Ca) y «eferentes» (Ce): quién usa cada paquete y qué usa él.
  5. «Inestabilidad» (I) y «abstracción» (A): dos números que solo tienen sentido juntos.
  6. «Distancia a la secuencia principal» (D): los paquetes en los que estabilidad y abstracción no van acompasadas.
  7. «Número de dependencias transitivas de paquete» (PDcy*): lo que arrastra un paquete si se quiere reutilizar o extraer.
  8. «Dependencia acumulada de componentes» (CCD): una cifra para todo el sistema de cuánto arrastra cada pieza.
  9. «Acoplamiento de cambio»: las dependencias que el código no muestra pero la historia sí.
  10. «Métricas de paquetes de Martin»: de dónde salen Ca, Ce, I, A y D, y sus críticas.

Heredar código ajeno

Para orientarse en un proyecto que no conoces antes de cambiar nada.

  1. «Líneas de código de paquete, módulo y proyecto» (LOC): la escala y dónde está el grueso del código.
  2. «Número de módulos» (MOD), «de paquetes» (P) y «de clases» (C): cómo está troceado.
  3. «Número de ficheros» (FILES) por tipo de fichero: de qué está hecho el proyecto además de Java.
  4. «Ratio de test» (TEST_RAT): qué módulos tienen red de seguridad y cuáles no.
  5. «Cobertura Javadoc de métodos» (Jm): dónde hay documentación que leer.
  6. «Número de comentarios TODO» (TODO): el trabajo pendiente que el equipo anterior dejó apuntado.
  7. «Puntos calientes de cambio»: dónde ha trabajado más el equipo anterior y, probablemente, dónde habrá que trabajar.
  8. «Propiedad del código»: quién conocía cada parte, y qué partes no conoce a fondo nadie.
  9. «Número de dependencias cíclicas» (Cyclic): las zonas que no se pueden entender por separado.

Planificar tests

Para decidir qué probar primero y cómo de bien están probadas las cosas.

  1. «Complejidad ciclomática» (v(G)): cuántos caminos independientes tiene un método, que es el número de tests que pide la prueba estructurada de McCabe.
  2. «Cobertura de código»: qué ejecutan ya los tests; una cobertura baja garantiza que hay código sin probar.
  3. «Número de veces invocado en código de test» (CALLEDt): los métodos a los que no llama ningún test.
  4. «Número de métodos de test JUnit» (JTM) y «número de aserciones de test JUnit» (JTA): cuántos tests hay y si comprueban algo.
  5. «Puntuación de mutación»: si los tests se darían cuenta de un error, que es lo que la cobertura no dice.
  6. «Respuesta para la clase» (RFC) y «número de dependencias transitivas» (Dcy*): cuánto código arrastra una clase al probarla, y cuánto habrá que sustituir por dobles.
  7. «Ratio de test» (TEST_RAT): el seguimiento en el tiempo, módulo a módulo.
  8. «Guía del aspecto: tests»: todas las métricas del aspecto y qué no miden.

Estudiar el tema a fondo

Para quien quiere entender de dónde salen las métricas, qué se sabe de ellas y qué no.

  1. «Teoría de la medición»: qué condiciones tiene que cumplir un número para ser una medida, y las propiedades de Weyuker.
  2. «Goal-Question-Metric»: cómo elegir qué medir a partir de una pregunta.
  3. «Métricas de McCabe» y «medidas de Halstead»: las dos familias fundacionales, de los años setenta.
  4. «Métricas de Chidamber y Kemerer»: el conjunto clásico de métricas para diseño orientado a objetos (WMC, CBO, RFC, LCOM, DIT, NOC).
  5. «Métricas MOOD», «de Lorenz y Kidd» y «de Li y Henry»: las alternativas y ampliaciones de los años noventa.
  6. «Métricas de paquetes de Martin»: el diseño de paquetes como cuestión medible.
  7. «De dónde salen los umbrales» y «agregar métricas»: los dos pasos que más cambian lo que dice un número.
  8. «Qué dice la evidencia empírica»: qué relación se ha encontrado con los defectos y el esfuerzo, y el efecto del tamaño.
  9. «Mapa de relaciones entre métricas» y «herramientas»: qué métricas miden casi lo mismo y por qué dos herramientas dan valores distintos.
  10. «Bibliografía»: todas las fuentes originales citadas en la referencia.