Pular para o conteúdo principal

Comentários em Java: como, quando e por que usá-los?

Se você está aprendendo Java, já deve ter se deparado com comentários no código. Mas será que você realmente sabe como usá-los de maneira certa?

Comentários podem transformar seu código em um material fácil de entender... ou um verdadeiro pesadelo!

Neste post, vou te mostrar os tipos comentários em Java, as boas práticas e erros comuns para que você nunca mais comenta os mesmos deslizes que muitos iniciantes cometem!

O que são comentários em Java?

Comentários são trechos de texto que podem ser inseridos no código para explicar o que ele faz. O compilador ignora esses comentários, ou seja, eles não afetam a execução do programa.

Eles são essenciais para documentar o código, tornando-o mais compreensível para você e para qualquer outra pessoa que precisar ler ou manter o projeto no futuro.

Tipos de comentários em Java

O Java oferece três tipos de comentários:

Comentários de uma linha (//)

Usados para pequenas explicações ou para desativar temporariamente uma linha de código.

Dica: use comentários curtos e diretos para explicar trechos específicos de código.

Comentários de múltiplas linhas (/* ... */)

Ótimos para explicações mais detalhadas ou para desativar blocos de código durantes testes.

Use com moderação! Se precisar de muitas explicações, prefira métodos bem nomeados e código claro.

Comentários de documentação (/** ... */)

Especiais para gerar documentação automática com o Javadoc. São usados para descrever classes, métodos e variáveis de forma profissional. 

Dica: sempre que criar métodos públicos, documente-os com Javadoc para facilitar o uso por outros desenvolvedores. 

Erros comuns ao usar comentários

Comentários óbvio demais:

Errado: o código já deixa claro que estamos somando!

Melhor forma:

Comentários desatualizados:

O comentário diz 10%, mais o código aplica 15%!

Mantenha os comentários sempre atualizados ou, melhor ainda, faço o código ser autoexplicativo!

Usar comentários de forma inteligente torna seu código mais claro e profissional. Evite comentários redundantes, mantenha boas práticas e use Javadoc para documentar códigos complexos.

Agora me conta: você já teve dificuldades para entender um código por falta de comentários? Ou já se deparou com comentários inúteis?

E se quiser ver outros conteúdos sobre Java, me diz nos comentários qual tema você quer que eu traga no blog! Vou adorar saber o que mais te interessa.


Marcadores:

Comentários

Postar um comentário

Postagens mais visitadas deste blog

A história do Java: como uma ideia revolucionou a programação

Se você já programou ou está começando no mundo da tecnologia, com certeza já ouviu falar do Java. Essa linguagem, que hoje é uma das mais populares do mundo, tem uma trajetória fascinante que envolve inovação, persistência e um pouco de sorte. Mas como tudo começou? Como um projeto experimental se tornou a espinha dorsal de grandes sistemas e aplicativos modernos? Vamos explorar a incrível história do Java!  O nascimento do Java: uma solução para a era digital  Tudo começou no início dos anos 90, quando a Sun Microsystems percebeu que o futuro da tecnologia estava na conectividade. Em um mundo que caminhava para dispositivos inteligentes e redes cadas vez mais interligadas, os engenheiros da Sun queria uma linguagem de programação que fosse portátil, segura e eficiente. Foi então que James Gosling, um dos principais desenvolvedores da Sun, iniciou um projeto chamado Oak . O objetivo inicial era criar uma linguagem para dispositivos eletrônicos como TVs interativas e eletrodom...
Postar um comentário
Leia mais

Instalando o Eclipse IDE no Windows: guia completo e simplificado

Se você quer desenvolver aplicações em Java, o Eclipse IDE  é uma das melhores ferramentas que você pode utilizar. Gratuito, poderoso e repleto de funcionalidades, o Eclipse é amplamente utilizado por desenvolvedores ao redor do mundo. Neste guia, você aprenderá como baixar, instalar e configurar  o Eclipse IDE no Windows , garantindo um ambiente de desenvolvimento eficiente e pronto para rodar seus projetos Java. Vamos nessa? Baixando o Eclipse IDE O primeiro passo é a versão mais recente do Eclipse. Siga os passos abaixo: Acesse o site oficial do Eclipse: https://www.eclipse.org/downloads/ .  Clique no botão "Download"  para baixar o instalador mais recente. Aguarde o download ser concluído antes de seguir para a instalação. Dica: se você deseja uma instalação mais personalizada, pode optar por baixar a versão Eclipse IDE for Java Developers , que já vem pré-configurada para desenvolvimento Java. Instalando o Eclipse IDE Após baixar o instalador, siga os passos aba...
Postar um comentário
Leia mais

Instalando o OpenJDK no Windows: guia completo e descomplicado

Se você está começando a programar em Java  ou precisa configurar um ambiente de desenvolvimento Windows , instalar o OpenJDK é um passo essencial. O OpenJDK (Java Development Kit)  é uma versão open-source do Java, amplamente usada por desenvolvedores ao redor do mundo para criar aplicações robustas e seguras. Neste tutorial, você aprenderá a instalar e configurar o OpenJDK no Windows de maneira simples, rápida e eficaz . Vamos nessa? Baixando o OpenJDK Diferente do JDK da Oracle, o OpenJDK não possui um instalador automático para Windows. Mas não se preocupe, o processo ainda é fácil! Para baixar a versão mais recente do OpenJDK, siga estes passos: Acesse o site oficial do OpenJDK: https://jdk.java.net/ . Escolha a versão desejada (recomenda-se OpenJDK 21 ou superior para suporte de longo prazo - LTS). Baixe o arquivo .zip  correspondente à sua arquitetura (geralmente x64 a maioria dos computadores). Extraindo e configurando o OpenJDK Agora que você tem o OpenJDK baixad...
Postar um comentário
Leia mais