...
← Curs Java: toate lecțiile
Lecția 4 · Afișare

Comentarii în Java

Codul este citit de oameni mult mai des decât este scris. Comentariile sunt note pentru tine și pentru colegii tăi: Java le ignoră complet, dar ele explică ce face programul și de ce.

Ce este un comentariu?

Un comentariu este text din cod pe care compilatorul îl sare. Nu se afișează și nu se execută. Îl scrii ca să explici sau ca să lași o notă.

public class Main {
    public static void main(String[] args) {
        // Afișăm mesajul de bun venit
        System.out.println("Bun venit!");
    }
}
Bun venit!

Linia cu // nu apare nicăieri în consolă. Ea există doar pentru cine citește codul.

Exercițiul tău

Scrie un program care afișează Comentariile nu se afișează. Adaugă deasupra instrucțiunii un comentariu pe o linie (//) și, la începutul lui main, un comentariu pe mai multe linii (/* ... */).

  • Scrie un comentariu pe mai multe linii cu /* și */.
  • Scrie un comentariu pe o linie cu //.
  • Afișează exact Comentariile nu se afișează.
Comentariile pot conține orice text. Ele nu schimbă ce se afișează în consolă.

Soluția exercițiului

public class Main {
    public static void main(String[] args) {
        /*
           Acest program arată
           cum funcționează comentariile.
        */
        // afișăm mesajul
        System.out.println("Comentariile nu se afișează");
    }
}
Excelent! Continuă cu lecția următoare →
Vrei să afli mai mult?Comentarii pe o singură linie: // · Comentarii pe mai multe linii: /* */ · Dezactivarea temporară a codului · Comentarii bune și comentarii inutile · În proiectele reale

Comentarii pe o singură linie: //

Tot ce urmează după //, până la finalul rândului, este comentariu. Îl poți pune pe un rând separat sau la finalul unei instrucțiuni.

// Calculăm totalul comenzii
System.out.println("Total: 45 lei"); // afișăm totalul
Total: 45 lei
Bine de știut

Codul din fața lui // se execută normal. Doar partea de după // este ignorată.

Comentarii pe mai multe linii: /* */

Când ai de scris o explicație mai lungă, folosește /* pentru început și */ pentru sfârșit. Tot ce este între ele este comentariu, oricâte rânduri ar avea.

/*
   Programul afișează meniul zilei.
   Autor: echipa restaurantului
   Actualizat: luni
*/
System.out.println("Ciorbă de legume");
System.out.println("Paste carbonara");
Ciorbă de legume
Paste carbonara
Atenție

Nu uita */ de la final. Fără el, tot codul de dedesubt devine comentariu, iar Java raportează o eroare de tipul unclosed comment.

Dezactivarea temporară a codului

Programatorii folosesc des comentariile ca să „oprească” o linie fără s-o șteargă. Este util când testezi ceva.

System.out.println("Pasul 1");
// System.out.println("Pasul 2");
System.out.println("Pasul 3");
Pasul 1
Pasul 3

Al doilea mesaj nu apare, pentru că instrucțiunea este acum comentariu. Dacă ștergi //, linia se execută din nou.

Comentarii bune și comentarii inutile

Un comentariu bun explică de ce faci ceva sau ce înseamnă o parte din program. Un comentariu inutil repetă exact ce se vede în cod.

InutilUtil
// afișează Salut// mesajul apare la prima deschidere a aplicației
// println// prețul include deja transportul
  • Scrie comentarii scurte și clare, în română.
  • Actualizează comentariul când schimbi codul.
  • Nu comenta fiecare linie: codul simplu se explică singur.

În proiectele reale

Lucru în echipă

Colegii înțeleg rapid ce face o parte din cod citind comentariile.

Mentenanță

Peste un an, tu însuți vei uita de ce ai scris ceva. Comentariul îți amintește.

Testare

Dezactivezi temporar linii cu // ca să găsești o problemă.

Main.javaJava
ConsolăSe încarcă Java...
Compilatorul Java se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Fundamente Java Lecția 4 · Comentarii în Java
Progres 0% 0 din 17
Lecția curentă 4 / 15 Afișare