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.
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ă.
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ă");
}
} 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 totalulTotal: 45 lei
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
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.
| Inutil | Util |
|---|---|
| // 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
Colegii înțeleg rapid ce face o parte din cod citind comentariile.
Peste un an, tu însuți vei uita de ce ai scris ceva. Comentariul îți amintește.
Dezactivezi temporar linii cu // ca să găsești o problemă.
