Escopo de variáveis em estruturas condicionais: evite os erros que confundem até os mais experientes

Se você está começando em Java (ou mesmo se já programa há um tempo), entender o escopo de variáveis é um daquelas viradas de chave que tornam seu código mais limpo, estável e fácil de manter.

E não se engane: muitos bugs nascem por simples desconhecimento de escopo. Neste post, você vai entender:

• O que é escopo de variável.
• O que acontece com variáveis declaradas dentro do if.
• Como evitar erros de escopo ao mover declarações para fora.
• E, claro, as boas práticas que todo programador Java deve seguir.

O que é escopo de variável?

Escopo, em programação, é o nome chique que damos para o "alcance" de uma variável. Ou seja:

Onde essa variável existe e pode ser usada dentro do código?

Em Java, o escopo é definido por blocos de códigos delimitados por chaves {}.

Se você declara uma variável dentro de um bloco, ela só existe ali dentro. Fora isso, ela é invisível. Desconhecida. Inalcançável.

Variáveis declaradas dentro do if são locais

Olha este exemplo:

Resultado: erro de compilação. A variável mensagem só existe dentro do if. Assim que o bloco terminal, ela é descartada da memória.

Como resolver? Declare antes do if

Agora veja a versão correta:

Perceba que agora a variável mensagem foi declarada fora do if, e só depois teve seu valor atribuído dentro dos blocos condicionais. 

Assim, ela continua existindo mesmo depois do if.

Boas práticas para declarar variáveis

• Declare variáveis o mais próximo possível de onde serão usadas, mas garanta que o escopo as abrace por completo.
• Evite declarar a mesma variável duas vezes no mesmo método, mesmo em blocos separados - isso causa confusão e pode gerar bugs sutis.
• Use nomes claros e significativos, principalmente ao declarar variáveis em escopos amplos.
• Evite "vazar" variáveis do if para fora desnecessariamente. Se você só vai usar dentro do bloco, declare ali mesmo.

Exemplo didático: validação de entrada

Antes (problema de escopo):

Depois (refatorado):

Agora o código é seguro, claro e funcional.

Entender o escopo de variáveis é uma habilidade essencial para qualquer desenvolvedor Java. Um pequeno detalhe como esse pode fazer toda a diferença entre um código estável e um código cheio de erros misteriosos. 

Sempre se pergunte:

Essa variável vai ser usada fora do if?
Então declare ela antes.
Vai ser usada apenas dentro?
Então mantenha ali dentro mesmo. Sem complicação.

Essa atenção ao escopo demonstra maturidade no código - e te aproxima do perfil de programador que grandes empresas valorizam.