Esfuerzo de Halstead

Actualizado el 15 de noviembre de 2026

Sigla E
Aspecto «Complejidad»
Se mide en método, clase
Tipo de valor puntuación (número real, mínimo 0)
Dirección más alto es peor
Origen Maurice H. Halstead, 1977
Familia «Medidas de Halstead»
Stau Metro HalsteadEffortMethod, HalsteadEffortClass

En pocas palabras

Combina en un solo número lo grande que es un trozo de código y lo denso que es. Un método corto y sencillo tiene poco esfuerzo; uno largo, o uno corto pero muy enrevesado, tiene más; uno largo y enrevesado se dispara. Es la medida de la familia de Halstead que más se acerca a «cuánto cuesta este código».

Qué mide

Halstead lo presentó como el esfuerzo mental necesario para escribir (y, por extensión, entender) un programa. La idea es sencilla:

  • el «volumen» dice cuánto hay que escribir, medido en bits;
  • la «dificultad» dice cuánto cuesta cada unidad, según lo denso que es el código.

El producto es el trabajo total. No tiene una unidad que se pueda observar: no son horas ni líneas. Halstead lo convertía en tiempo dividiéndolo entre una constante, lo que da el «tiempo de programación», y en defectos esperados, lo que da los «errores estimados».

Cómo se calcula

E=D⋅VE = D \cdot V

Desarrollado con los cuatro recuentos básicos (n1n_1, n2n_2 operadores y operandos distintos; N1N_1, N2N_2 apariciones):

E=n12⋅N2n2⋅(N1+N2)log⁡2(n1+n2)E = \frac{n_1}{2} \cdot \frac{N_2}{n_2} \cdot (N_1 + N_2) \log_2 (n_1 + n_2)

Ejemplo

Con los valores del método withTax de la página de la «longitud», D≈5,333D \approx 5{,}333 y V≈76,147V \approx 76{,}147:

E≈5,333⋅76,147≈406,1E \approx 5{,}333 \cdot 76{,}147 \approx 406{,}1

Para la clase Prices que lo contiene, D=7,5D = 7{,}5 y V≈116,692V \approx 116{,}692:

E≈7,5⋅116,692≈875,2E \approx 7{,}5 \cdot 116{,}692 \approx 875{,}2

La clase solo tiene siete tokens más que su método, pero más del doble de esfuerzo: los dos factores crecen a la vez.

El caso que fija un test del proyecto, void m() { f = f + f + f; } con f un campo de tipo int, tiene D=6D = 6 y V=16V = 16: E=96E = 96.

Cómo interpretarla

Stau Metro no le asigna umbrales de referencia. Sirve para ordenar: los métodos y las clases con más esfuerzo son candidatos a revisión, porque son a la vez grandes y densos.

  • Un valor alto indica código que cuesta escribir y leer: mucho contenido, con muchas operaciones distintas sobre datos que se reutilizan. Es donde más fácil es equivocarse al cambiar algo.
  • Un valor bajo indica código corto y con pocas operaciones distintas. Un método largo casi nunca lo tiene: aunque sea repetitivo, la repetición sube la dificultad y la longitud sube el volumen.

Como el esfuerzo multiplica dos medidas que suelen crecer con el tamaño, crece más deprisa que el tamaño. Esa es su utilidad y su riesgo: destaca mucho los métodos grandes y densos frente a los demás, de modo que una media por clase o por paquete la dominan unos pocos valores. Mira los máximos antes que la media.

Qué hacer con un valor alto: lo mismo que con un método largo y difícil. Extrae métodos con nombre para cada paso; cada parte tendrá menos volumen y, normalmente, menos operadores distintos.

Ojo. El número no es un tiempo ni un coste. Sirve para comparar fragmentos medidos con la misma herramienta, no para estimar plazos.

Para profundizar

De dónde sale. El esfuerzo descansa en la parte más teórica de la software science: la idea de que el trabajo de escribir un programa se puede deducir de su volumen y de su nivel (E=V/LE = V / L, con la dificultad como inversa del nivel). Shen, Conte y Dunsmore (1983) hicieron una crítica de esa teoría y revisaron los experimentos publicados para validarla.

Sensibilidad a las reglas de recuento. El esfuerzo hereda las decisiones de la herramienta sobre qué es un operador (palabras clave de las declaraciones, signos de puntuación, llamadas a métodos) y las amplifica, porque entran en los dos factores. Los esfuerzos de herramientas distintas no son comparables.

Formas de falsearlo. Dividir un método en varios pequeños baja el esfuerzo de cada uno, aunque la lógica global no cambie; es el efecto buscado cuando la división tiene sentido, y un engaño cuando las partes no se entienden por separado.

Relación con otras métricas

En las herramientas

Stau Metro (HalsteadEffortMethod por método, HalsteadEffortClass por clase). Multiplica la dificultad y el volumen calculados con sus propias reglas de recuento, descritas en la página de la «longitud», en los mismos niveles: métodos no abstractos (constructores incluidos) y clases, enumerados y records, sin interfaces. Si no hay operandos o el vocabulario es 0, el esfuerzo vale 0.

Radon (Python) define el esfuerzo con la misma fórmula, E=D⋅VE = D \cdot V.

Referencias