...
← Curs Kotlin (Android): toate lecțiile
Lecția 3 · Primii pași

Comentarii în cod

Codul nu este scris doar pentru calculator, ci și pentru oameni: colegii tăi și tu, peste câteva luni. Comentariile sunt note pe care compilatorul le ignoră complet. În această lecție înveți cele două feluri de comentarii din Kotlin și cum să „oprești” temporar o linie de cod.

Ce este un comentariu?

Un comentariu este un text din cod pe care compilatorul nu îl citește. Nu se execută și nu apare în consolă. Îl scrii ca să explici *de ce* ai făcut ceva sau ca să lași o notă pentru mai târziu.

În Kotlin, tot ce urmează după // până la finalul rândului este comentariu:

fun main() {
    // Acest program salută utilizatorul
    println("Bună ziua!") // afișează salutul
}
Bună ziua!
Reține

Comentariul poate sta pe un rând separat sau la finalul unei instrucțiuni. În ambele cazuri, de la // încolo totul este ignorat.

Exercițiul tău

Starter-ul afișează trei rânduri. Comentează instrucțiunea care afișează Linia 2, astfel încât în consolă să apară doar Linia 1 și Linia 3.

  • Nu șterge rândul cu Linia 2: pune // în fața lui.
  • Lasă neschimbate celelalte două instrucțiuni.
  • Rulează și verifică faptul că apar doar două rânduri.
Pune // la începutul rândului println("Linia 2").

Soluția exercițiului

fun main() {
    println("Linia 1")
    // println("Linia 2")
    println("Linia 3")
}
Excelent! Continuă cu lecția următoare →
Vrei să afli mai mult?Comentarii pe mai multe rânduri · De ce comentăm? · Comentarea temporară a unei linii · Greșeli frecvente · Comentariile în proiecte reale

Comentarii pe mai multe rânduri

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

fun main() {
    /*
      Program: mesajul de bun venit
      Autor: echipa Academiei
      Afișează două rânduri în consolă.
    */
    println("Bun venit!")
    println("Spor la învățat!")
}
Bun venit!
Spor la învățat!
Atenție

Fiecare /* trebuie închis cu */. Dacă uiți închiderea, tot restul fișierului devine comentariu, iar compilatorul se plânge că lipsesc acolade.

De ce comentăm?

  • Explici intenția: // livrarea e gratuită peste 200 lei spune de ce există o regulă, nu doar ce face codul.
  • Lași note pentru echipă: într-o aplicație reală lucrează mai mulți programatori pe același cod.
  • Îți ajuți memoria: peste trei luni nu vei mai ține minte de ce ai ales o anumită valoare.

Un comentariu bun nu repetă codul. println("Salut") // afișează Salut nu aduce nimic nou; // mesajul apare la prima deschidere a aplicației explică un context pe care codul nu îl arată.

Comentarea temporară a unei linii

Programatorii folosesc des comentariile ca să „oprească” o instrucțiune fără să o șteargă. Pui // în fața ei, iar linia nu se mai execută:

fun main() {
    println("Pasul 1: pregătim comanda")
    // println("Pasul 2: trimitem un SMS de test")
    println("Pasul 3: comanda a fost trimisă")
}
Pasul 1: pregătim comanda
Pasul 3: comanda a fost trimisă

Rândul cu Pasul 2 este încă în fișier, dar compilatorul îl ignoră. Când vrei să-l folosești din nou, ștergi // din fața lui.

Scurtătură

În majoritatea editoarelor (inclusiv Android Studio), Ctrl + / (pe Mac Cmd + /) comentează sau decomentează rândul pe care se află cursorul.

Greșeli frecvente

  • **Un singur /**: / comentariu nu este comentariu, ci o eroare de sintaxă.
  • Comentariu închis greșit: /* text /* nu se închide; închiderea este */.
  • Comentarii învechite: dacă schimbi codul, actualizează și comentariul, altfel acesta minte.
  • **// în interiorul unui text**: în println("http://site.ro") cele două bare fac parte din text, nu încep un comentariu.

Comentariile în proiecte reale

Lucru în echipă

Într-o aplicație de livrări, comentariile explică regulile de business: de ce comanda minimă e 30 de lei sau de ce o reducere se aplică doar luni.

Depanare

Când cauți o greșeală, comentezi pe rând câte o instrucțiune ca să vezi care dintre ele produce problema.

Documentație

Comentariile speciale /** ... */ (KDoc) generează automat documentația bibliotecilor Kotlin și Android.

main.ktKotlin
ConsolăSe încarcă...
Mediul de lucru 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 Kotlin Lecția 3 · Comentarii în cod
Progres 0% 0 din 17
Lecția curentă 3 / 15 Primii pași