Número de módulos

Actualizado el 15 de noviembre de 2026

Sigla MOD
Aspecto «Tamaño»
Se mide en proyecto
Tipo de valor recuento (entero, mínimo 0)
Dirección informativa: ni alto ni bajo es mejor
Stau Metro NumModulesInProject

En pocas palabras

Cuenta en cuántas piezas está dividido el proyecto. Un proyecto de un solo módulo da 1; uno multimódulo de Maven o Gradle da tantos como módulos con ficheros tenga.

Qué mide

La división del proyecto en módulos, que es la unidad de construcción y de dependencia más gruesa que ve el IDE. Muchos módulos pequeños suelen indicar una arquitectura por capas o por funciones con fronteras explícitas; pocos módulos grandes, un monolito con las fronteras dentro de los paquetes.

Aquí «módulo» es el del IDE (un módulo de IntelliJ, que el IDE crea al importar un proyecto Maven o Gradle), no un módulo de la plataforma Java (module-info.java).

Ojo. Un módulo del IDE no siempre es un módulo de la construcción. Al importar un proyecto Gradle, el IDE representa cada conjunto de fuentes (source set: main, test…) como un módulo propio, agrupado bajo el del proyecto Gradle. Un proyecto Gradle de un solo módulo puede dar así un MOD de 2 o 3.

Cómo se calcula

Se cuentan los módulos distintos a los que pertenece al menos un fichero del ámbito analizado:

MOD=∣{ moˊdulo(f):f∈F }∣\text{MOD} = |\{\, \text{módulo}(f) : f \in F \,\}|

con FF los ficheros que recorre el análisis, sean Java o no. Un módulo sin ningún fichero en el ámbito no se cuenta.

Cómo interpretarla

No tiene valor bueno ni malo y no tiene umbrales. Se interpreta con otras cifras:

  • el «número de ficheros» y de «paquetes» dividido por MOD da el tamaño medio de un módulo;
  • en el tiempo, un aumento sostenido puede ser una modularización deliberada o una fragmentación sin criterio; este número por sí solo no las distingue.

Como el ámbito puede ser solo una parte del proyecto, el valor depende de lo que se haya analizado: analizar un directorio da el número de módulos que tocan esos ficheros.

Relación con otras métricas

En las herramientas

Stau Metro (NumModulesInProject). Recorre los ficheros del análisis y cuenta cada módulo del IDE la primera vez que aparece. Cualquier fichero que recorra el análisis sirve, no solo los Java (valen las reglas de «FILES»): un módulo con solo un .kt y un .xml cuenta 1, y un módulo de documentación sin Java también cuenta. Un módulo cuyos ficheros están todos excluidos o fuera del ámbito no cuenta.

Referencias