Ghi chú / Chú thích (Comment) trong Kotlin

1. Single-line Comment (Chú thích một dòng)

Sử dụng // để chú thích một dòng:

// Đây là chú thích một dòng
val name = "Kotlin"  // Khai báo biến name
 
// Chú thích có thể ở đầu dòng
println(name)

2. Multi-line Comment (Chú thích nhiều dòng)

Sử dụng /* ... */ để chú thích nhiều dòng:

/*
Đây là chú thích
nhiều dòng trong Kotlin
*/
val age = 25
 
/*
 * Có thể format đẹp hơn
 * với dấu sao ở đầu mỗi dòng
 */

3. KDoc Comment (Documentation)

KDoc tương tự Javadoc, dùng để tạo documentation:

/**
 * Tính tổng hai số
 *
 * @param a Số thứ nhất
 * @param b Số thứ hai
 * @return Tổng của a và b
 */
fun sum(a: Int, b: Int): Int {
    return a + b
}

4. Nested Comments

Kotlin hỗ trợ nested block comments (khác với Java):

/*
Outer comment
/* Nested comment */
Still in outer comment
*/

5. TODO Comments

// TODO: Implement feature X
// FIXME: Bug in calculation
// NOTE: Important information

6. So sánh với Python

📝 Best Practices

1. Viết comment rõ ràng, giải thích TẠI SAO chứ không phải CÁI GÌ
2. Cập nhật comment khi thay đổi code
3. Sử dụng KDoc cho public APIs
4. Tránh comment quá nhiều - code tốt tự giải thích