9 Métricas de Qualidade de Código que Indicam Saúde do Software

Métricas de código são medidas objetivas que traduzem a saúde do software em números. Elas ajudam equipes a identificar gargalos de manutenibilidade, complexidade excessiva e riscos de falha. Abaixo, as 9 métricas mais relevantes para avaliar qualidade de código, ordenadas por impacto prático.

1. Complexidade Ciclomática (CC)

Mede o número de caminhos independentes no código. Quanto maior a CC, mais difícil testar e manter. Um método com CC acima de 10 merece refatoração. Ferramentas como SonarQube e Visual Studio calculam automaticamente.

2. Linhas de Código (LOC)

Contagem bruta de linhas, excluindo comentários e linhas em branco. Útil como referência, mas isolada não indica qualidade. Uma classe com mais de 500 LOC provavelmente viola o princípio da responsabilidade única.

3. Profundidade de Herança (DIT)

Número de níveis na hierarquia de herança. DIT acima de 6 geralmente indica complexidade indesejada, pois mudanças na base afetam todas as subclasses. Prefira composição sobre herança.

4. Acoplamento entre Classes (CBO)

Quantidade de classes que uma classe depende. CBO alto significa maior fragilidade a mudanças. Um valor acima de 14 por classe sugere baixa modularização.

5. Falta de Coesão (LCOM)

Mede quão bem os métodos de uma classe compartilham seus atributos. LCOM alto indica que a classe faz mais de uma coisa. Idealmente, LCOM deve ser próximo de zero.

6. Índice de Manutenibilidade (MI)

Compõe complexidade, volume e legibilidade. Varia de 0 a 100. Valores acima de 65 indicam código de fácil manutenção; abaixo de 20, crítico. É a métrica mais consolidada para prever esforço de manutenção.

7. Cobertura de Testes

Percentual de código executado durante os testes. Não garante qualidade, mas cobertura abaixo de 60% expõe risco alto. Ferramentas como JaCoCo e Istanbul geram relatórios por linha e branch.

8. Duplicação de Código

Percentual de linhas duplicadas no projeto. Acima de 5% já merece atenção. Duplicação aumenta custo de manutenção e propaga bugs. SonarQube detecta blocos repetidos.

9. Dívida Técnica

Estimativa do esforço para corrigir problemas estruturais. Medida em dias/homem ou percentual do custo de desenvolvimento. Ferramentas como SonarQube calculam baseada em violações de regras.

Qual métrica priorizar?

Para um time iniciando, comece com Complexidade Ciclomática e Índice de Manutenibilidade. Eles capturam os riscos mais comuns. Depois, adicione Cobertura de Testes e Duplicação. Use um dashboard consolidado, não métricas isoladas.

Perguntas Frequentes

Qual a diferença entre métrica de código e qualidade de software?

Métrica de código é uma medida quantitativa do código fonte (linhas, complexidade). Qualidade de software é um conceito mais amplo que inclui funcionalidade, desempenho e segurança. Métricas são um indicador, não o fim.

Como interpretar a complexidade ciclomática?

Valores de 1 a 10 são baixos e seguros. De 11 a 20, moderados, vale revisar. Acima de 20, complexidade alta, com alta probabilidade de defeitos. Acima de 50, praticamente impossível de testar exaustivamente.

É possível ter código limpo com métricas ruins?

Sim, métricas não capturam legibilidade ou design. Um código com baixa CC pode ser ilegível. Use métricas como guia, não como verdade absoluta. Combine com code review.

Qual ferramenta usar para medir métricas de código?

SonarQube é a mais completa e gratuita. Para projetos menores, ferramentas integradas ao IDE (Visual Studio, IntelliJ) já oferecem CC, LOC e MI. Para cobertura, JaCoCo (Java) ou Istanbul (JavaScript).

Como reduzir a dívida técnica?

Priorize refatorações com base no custo-benefício. Corrija primeiro violações de segurança e bugs críticos. Depois, reduza duplicação e complexidade. Estabeleça um orçamento de dívida técnica por sprint.

Métricas de código servem para qualquer linguagem?

A maioria das métricas (CC, LOC, MI) é independente de linguagem. Algumas, como profundidade de herança, fazem menos sentido em linguagens funcionais. Adapte o conjunto ao paradigma do projeto.