τTau SolutionsAspectos de calidad

Guía del aspecto: Tamaño

Actualizado el 15 de noviembre de 2026

El tamaño contesta a la pregunta más sencilla que se le puede hacer a un código: ¿cuánto hay? Cuánto texto hay que leer, entre cuántas piezas está repartido y cuánto comportamiento define. Es el aspecto con más métricas porque hay muchas cosas que contar (líneas, ficheros, clases, métodos, sentencias) y muchos sitios donde contarlas (método, clase, paquete, módulo, proyecto).

Casi ninguna métrica de tamaño dice por sí sola si el código está bien o mal. Sirven para tres cosas:

  • Localizar lo que se sale de lo normal: el método de 200 líneas, la clase con 80 métodos.
  • Dar escala: saber si un módulo es el grueso del sistema o un apéndice, o cuánto hay de producción y cuánto de test.
  • Normalizar otras medidas: defectos por cada mil líneas, comentarios por línea de código, métodos por clase.

Para quien empieza. Si solo vas a mirar una métrica de tamaño, que sea la de líneas de código sin comentarios de cada método. Las demás sirven sobre todo para entender el contexto.

Por dónde empezar

  1. «Líneas de código sin comentarios» (NCLOC) por método. Es la única métrica del aspecto que el catálogo de Stau Metro marca como esencial y la única con umbrales de referencia: aviso por encima de 30 líneas y error por encima de 100 (umbrales de referencia de Stau Metro, una convención del plugin). Como no cuenta comentarios, documentar un método no lo hace «crecer».
  2. «Líneas de código» (LOC) y «líneas sin comentarios» (NCLOC) por paquete, módulo y proyecto. Dan el mapa: qué partes del sistema son grandes. Las variantes de «producción» (LOCp) y de «test» (LOCt) separan lo que se entrega de su suite de pruebas.
  3. «Número de métodos» (METH) y «número de clases» (C). Dicen entre cuántas piezas se reparte el código; divididos entre sí dan los métodos por clase.

Cuando un método sale largo, el paso siguiente no es otra métrica de tamaño, sino la «complejidad ciclomática» (v(G)): un método largo y plano es mucho menos preocupante que uno largo y lleno de decisiones.

Las métricas, por lo que cuentan

Todas las métricas de esta tabla menos los puntos de función las calcula Stau Metro. «Peor si sube» indica que el plugin les da la dirección «más alto es peor»; las demás son informativas: ni alto ni bajo es mejor.

Líneas

Métrica Niveles Qué cuenta Dirección
«Líneas de código» (LOC) método, clase, interfaz líneas no vacías, comentarios incluidos peor si sube
«Líneas de código» (LOC) paquete, módulo, proyecto, tipo de fichero lo mismo, sumado por ficheros enteros informativa
«Líneas sin comentarios» (NCLOC) método, clase, interfaz líneas con código, sin blancos ni líneas solo de comentario peor si sube
«Líneas sin comentarios» (NCLOC) paquete, módulo, proyecto, tipo de fichero lo mismo, sumado por ficheros informativa
«Líneas de producción» (LOCp) paquete, módulo, proyecto LOC de los ficheros de producción informativa
«Líneas sin comentarios de producción» (NCLOCp) paquete, módulo, proyecto NCLOC de los ficheros de producción informativa
«Líneas de Java» (L(J)) módulo, proyecto líneas no vacías de los .java informativa
«Líneas de Kotlin» (L(KT)) módulo, proyecto líneas no vacías de los .kt informativa
«Líneas de XML» (L(XML)) módulo, proyecto líneas no vacías de los ficheros XML informativa
«Líneas de HTML» (L(HTML)) módulo, proyecto líneas no vacías de los ficheros HTML informativa

Ficheros y estructura del proyecto

Métrica Niveles Qué cuenta Dirección
«Número de ficheros» (FILES) módulo, proyecto, tipo de fichero ficheros no binarios que visita el análisis informativa
«Ficheros Java» (J) módulo, proyecto ficheros .java informativa
«Ficheros Kotlin» (KT) módulo, proyecto ficheros .kt, sin scripts informativa
«Ficheros XML» (XML) módulo, proyecto ficheros de tipo XML informativa
«Ficheros HTML» (HTML) módulo, proyecto ficheros de tipo HTML informativa
«Número de módulos» (MOD) proyecto módulos con algún fichero analizado informativa
«Número de paquetes» (P) proyecto paquetes con al menos una clase informativa

Clases por tipo

Métrica Niveles Qué cuenta Dirección
«Número de clases» (C) paquete, módulo, proyecto todos los tipos declarados, anidados, locales y anónimos incluidos informativa
«Clases de producción» (Cp) paquete, módulo, proyecto los tipos de las raíces de fuentes de producción informativa
«Clases abstractas» (AC) paquete, módulo, proyecto clases con abstract, sin interfaces informativa
«Clases concretas» (CC) paquete, módulo, proyecto ni abstractas, ni interfaces, ni enumerados informativa
«Enumerados» (EC) paquete, módulo, proyecto tipos enum informativa
«Interfaces» (IC) paquete, módulo, proyecto interfaces, anotaciones incluidas informativa
«Interfaces de anotación» (ANC) paquete, módulo, proyecto declaraciones @interface informativa
«Clases anónimas» (AnoC) paquete new Tipo() { ... } informativa
«Clases de nivel superior» (NTC) paquete, módulo, proyecto clases, enumerados y records no anidados informativa
«Interfaces de nivel superior» (NTI) paquete, módulo, proyecto interfaces no anidadas, anotaciones incluidas informativa

Miembros de clase e interfaz

Métrica Niveles Qué cuenta Dirección
«Tamaño de la clase (operaciones)» (CSO) clase métodos propios, constructores incluidos, y heredados, uno por firma informativa
«Tamaño de la clase (atributos)» (CSA) clase campos propios y no estáticos heredados informativa
«Tamaño de la clase (operaciones + atributos)» (CSOA) clase CSO + CSA informativa
«Tamaño de la interfaz (operaciones)» (ISO) interfaz métodos propios y heredados de otras interfaces peor si sube
«Tamaño de la interfaz (atributos)» (ISA) interfaz constantes declaradas en la propia interfaz informativa
«Tamaño de la interfaz (operaciones + atributos)» (ISOA) interfaz ISO + ISA informativa
«Número de constructores» (Cons) clase constructores escritos en el fuente informativa
«Número de clases internas» (Inner) clase tipos miembro declarados directamente informativa
«Número de parámetros de tipo» (NTP) método, clase, interfaz parámetros genéricos declarados (<T>) informativa

Operaciones

Métrica Niveles Qué cuenta Dirección
«Número de métodos» (METH) paquete, módulo, proyecto métodos declarados, constructores incluidos informativa
«Número de comandos» (Command) clase, interfaz métodos void informativa
«Número de consultas» (Query) clase, interfaz métodos que devuelven un valor informativa
«Número de lambdas» (LAMBDA) paquete expresiones lambda informativa
«Tamaño promedio de las operaciones» (OSavg) clase sentencias por método, de media peor si sube
«Tamaño máximo de las operaciones» (OSmax) clase sentencias del método más largo peor si sube
«Líneas de código relativas» (RLOC) método fracción de las líneas de su clase que ocupa el método informativa

Sentencias y expresiones

Métrica Niveles Qué cuenta Dirección
«Número de sentencias» (STAT) método, clase sentencias, de control incluidas peor si sube
«Sentencias ejecutables» (EXEC) método sentencias que hacen trabajo directo, sin las de control peor si sube
«Número de expresiones» (EXP) método expresiones evaluadas, subexpresiones incluidas informativa

Tamaño funcional

Métrica Niveles Qué cuenta Dirección
«Puntos de función» (FP) aplicación la funcionalidad que se ofrece al usuario, según los requisitos informativa

Stau Metro no calcula los puntos de función: todas sus métricas miden el código, y los puntos de función miden lo que el software hace para quien lo usa, con independencia del lenguaje. Se incluyen aquí porque son la otra gran respuesta a «¿cuánto hay?» y el contrapunto de todas las anteriores.

Hay más métricas de tamaño en otros aspectos: las de código de test («LOCt», «NCLOCt», «Ct») están en «Tests», y las medidas de Halstead, como la «longitud» (N) o el «volumen» (V), que también miden tamaño a su manera, en «Complejidad».

Cómo se combinan

Particiones y sumas. Varias métricas encajan como piezas de un total, y esas identidades sirven para comprobar que se entiende lo que se lee:

  • C = AC + CC + EC + IC: toda clase es abstracta, concreta, enumerado o interfaz. Las anotaciones están dentro de IC (ANC ≤ IC) y las clases anónimas dentro de CC (AnoC ≤ CC).
  • C = Cp + «Ct»: producción más test.
  • CSOA = CSO + CSA, e ISOA = ISO + ISA.
  • En una clase, Command + Query son sus métodos declarados sin contar los constructores, que mide Cons.
  • En un método, una clase o una interfaz, LOC − NCLOC es el número de líneas que solo tienen comentario (en los agregados no, porque NCLOC deja fuera los ficheros de texto plano). No coincide con las «líneas de comentario» (CLOC), que cuentan también las líneas donde un comentario comparte línea con código.
  • STAT − EXEC es, en lo esencial, el esqueleto de control de un método.

Cocientes. Dividir un recuento entre otro dice más que cualquiera de los dos: LOC / FILES es el tamaño medio de un fichero, METH / C los métodos por clase, C / P las clases por paquete. Lanza y Marinescu organizaron cocientes de este tipo en su pirámide de visión general, que se cuenta en «Lanza y Marinescu».

Media y máximo. OSavg y OSmax se leen juntas: una clase con media baja y máximo alto tiene un método que conviene dividir; una con las dos altas tiene un problema de estilo general. La diferencia entre resumir con la media o con el máximo se trata en «Agregar métricas».

Líneas frente a sentencias. Las líneas dependen del formato: dónde se pone la llave, cómo se parte una expresión larga. STAT no, porque cuenta sentencias. Si dos equipos con estilos distintos comparan tamaños, las sentencias son más justas; para hablar con otras herramientas, las líneas son el idioma común.

Tamaño como denominador. Muchas métricas de otros aspectos son un recuento dividido entre un tamaño: el «ratio de comentarios» (COM_RAT), el «ratio de test» (TEST_RAT) o la «densidad de defectos». Si el tamaño se mide con otra regla, esos cocientes cambian también.

Tamaño junto a complejidad. Un método largo con v(G) baja suele ser código plano (un mapeo, una tabla de constantes) y se puede tolerar. Uno de tamaño moderado con muchas decisiones es el que cuesta mantener. Para la clase, la «complejidad ponderada de los métodos» (WMC) suma los métodos declarados en la clase ponderados por su complejidad; con ponderación unitaria se reduce a su número. CSO, en cambio, suma también los heredados.

Qué no miden

  • Calidad. Un número alto no es un defecto. Una clase de constantes puede ser enorme y estar bien; un método de diez líneas puede ser incomprensible. Solo NCLOC por método lleva umbrales en Stau Metro, y aun así es una señal para mirar, no un veredicto.
  • Funcionalidad. El mismo comportamiento ocupa muchas más líneas en un lenguaje que en otro, y refactorizar suele bajar las líneas sin quitar funcionalidad. Para medir lo que el software hace están los «puntos de función».
  • Esfuerzo ni productividad. Contar líneas escritas para medir a personas invita a escribir de más.
  • Valores comparables entre herramientas. «Líneas de código» no es una sola cosa: el LOC de Stau Metro no cuenta las líneas vacías pero sí los comentarios, mientras que SonarQube separa lines (líneas físicas) de ncloc (sin blancos ni comentarios). Los recuentos de miembros tampoco coinciden: el CSO de MetricsReloaded incluye los métodos de Object y el de Stau Metro no. Antes de comparar cifras, mira la sección «En las herramientas» de cada página.
  • Kotlin, salvo ficheros y líneas. En Stau Metro el código Kotlin solo entra en KT, L(KT) y en los recuentos generales de ficheros y líneas; las métricas de clases, métodos y sentencias ven solo Java.

Para profundizar

Qué es una línea. La variedad de definiciones de «línea de código» llevó a Park y otros a publicar en 1992, en el Software Engineering Institute, un marco para declarar con exactitud qué se cuenta: comentarios, líneas vacías, código generado o reutilizado. La distinción clásica es entre líneas físicas (lo que miden LOC y NCLOC) y líneas lógicas, que cuentan sentencias (lo más cercano es STAT). Las páginas de «LOC» y «NCLOC» lo desarrollan.

El tamaño como factor de confusión. El tamaño importa también en la evidencia sobre las demás métricas. El Emam, Benlarbi, Goel y Rai (2001) analizaron las métricas de Chidamber y Kemerer y parte de las de Lorenz y Kidd sobre un framework de telecomunicaciones en C++ y encontraron que, antes de controlar el tamaño de la clase, se asociaban con la propensión a fallos como en estudios anteriores; después de controlarlo, ninguna seguía asociada. Concluyeron que eso ponía en duda los estudios de validación previos y que había que revisarlos controlando el tamaño. Gil y Lalouche (2017) fueron más lejos: sostienen que la validez aparente de una métrica se puede predecir a partir de su correlación con el tamaño del código. La consecuencia práctica es que, antes de atribuir a una métrica de acoplamiento o de cohesión un poder predictivo, conviene preguntarse si no está midiendo, en el fondo, el tamaño. Más en «Qué dice la evidencia empírica».

Tamaño funcional. Albrecht propuso los puntos de función en IBM y presentó el método en 1979, para medir la productividad sin depender del lenguaje. Hoy hay varios métodos normalizados (IFPUG, NESMA, Mark II, COSMIC), y los recuentos solo se comparan dentro de un mismo método: puntos IFPUG y puntos COSMIC no se suman ni se comparan. Las críticas principales son la subjetividad del recuento y unos pesos fijados por convenio; la «página de la métrica» las detalla.

Tamaño de clase orientado a objetos. Las métricas CSO, CSA y CSOA recogen la idea de «tamaño de clase» de «Lorenz y Kidd», que miden el tamaño de una clase por sus operaciones y sus atributos. Los resúmenes de su propuesta no precisan qué operaciones entran; la forma habitual en las herramientas, y la de Stau Metro, cuenta también lo heredado. METH y P aparecen, con las siglas NOM y NOP, en la pirámide de «Lanza y Marinescu».

Cómo lo organiza Stau Metro

El plugin agrupa en este aspecto 46 conceptos; con los puntos de función, esta guía cubre 47 páginas. Algunas reglas afectan a muchas métricas a la vez:

  • Test y producción. Casi todos los recuentos incluyen el código de test, si el ámbito analizado lo contiene. Las variantes con sufijo p (Cp, LOCp, NCLOCp) se limitan a las raíces de producción, y las de test están en el aspecto «Tests».
  • Paquete recursivo. Muchas métricas de paquete tienen una variante recursiva (C(rec), LOC(rec)…) que suma los subpaquetes. El paquete por defecto solo recibe lo suyo.
  • Qué paquete. METH, por ejemplo, asigna cada fichero al paquete de su directorio; P, en cambio, usa la sentencia package. En un proyecto bien formado coinciden.
  • Ficheros fuera de las fuentes. Las líneas y ficheros de módulo y proyecto (LOC, NCLOC, FILES) cuentan también ficheros que no están en ninguna raíz de fuentes, como un README o un script de construcción; las líneas de producción (LOCp, NCLOCp) y las de paquete se limitan a las raíces de fuentes.

Referencias

  • El Emam, K., Benlarbi, S., Goel, N. y Rai, S. N. (2001). «The Confounding Effect of Class Size on the Validity of Object-Oriented Metrics». IEEE Transactions on Software Engineering, 27(7), 630-650. https://doi.org/10.1109/32.935855
  • Gil, Y. y Lalouche, G. (2017). «On the Correlation between Size and Metric Validity». Empirical Software Engineering, 22(5), 2585-2611. https://doi.org/10.1007/s10664-017-9513-5
  • Park, R. E. y otros (1992). Software Size Measurement: A Framework for Counting Source Statements. Informe técnico CMU/SEI-92-TR-20, Software Engineering Institute, Carnegie Mellon University.
  • Lanza, M. y Marinescu, R. (2006). Object-Oriented Metrics in Practice. Springer.
  • Lorenz, M. y Kidd, J. (1994). Object-Oriented Software Metrics: A Practical Guide. Prentice Hall.
  • Albrecht, A. J. (1979). «Measuring Application Development Productivity». Proceedings of the Joint SHARE, GUIDE and IBM Application Development Symposium, 83-92.
  • SonarQube, definición de métricas: https://docs.sonarsource.com/sonarqube-server/latest/user-guide/code-metrics/metrics-definition/