Komentar

Tulis komentar sebaris, blok, dan komentar dokumentasi.

Pahami konsepnya

Go mengenal dua bentuk komentar: // untuk satu baris dan /* ... */ untuk blok. Kompilator mengabaikan semuanya — komentar murni untuk manusia: menjelaskan alasan, bukan mengulang apa yang kode sudah katakan.

Bentuk istimewa adalah komentar dokumentasi: komentar yang ditulis tepat di atas deklarasi (fungsi, tipe, konstanta) dan diawali namanya. Ini adalah sumber dokumentasi resmi Go — perintah go doc dan situs pkg.go.dev membacanya, dan alat dokumentasi lain pun menampilkannya.

Komentar yang baik menjawab "kenapa", bukan "apa". Konvensi komunitas: singkat, kalimat lengkap, di dokumen bahasa Inggris agar konsisten dengan ekosistem — tapi untuk berlatih, bahasa apa pun sah.

Coba contoh kode

package main

import "fmt"

// Sapa menyapa pengguna dengan nama yang diberikan.
func Sapa(nama string) string {
    return "Halo, " + nama + "!"
}

func main() {
    // Komentar satu baris: penjelas singkat langkah di bawahnya.
    fmt.Println(Sapa("Ari")) /* blok: jarang dipakai, */
}

Komentar di atas Sapa adalah komentar dokumen: diawali nama fungsinya, menjelaskan apa yang dilakukan. Jalankan go doc Sapa dan kalimat itu muncul. Komentar dalam fungsi menjelaskan langkah spesifik — cukup di mana kodemu butuh alasan tambahan.

Latihan singkat

Uji: beri komentar pada baris cetaknya agar program berjalan TANPA mencetak apa pun (keluaran kosong).