Clean Code: 3 Nguyên tắc cốt lõi

1. Đặt tên có tâm (Meaningful Names)

Tên biến, tên hàm, tên class… là mặt tiền của code. Nó càng rõ ràng thì bạn (và đồng đội) càng đỡ đau đầu.

❌ Bad:

const d = new Date(); // current date

d là cái gì? deadline? discount? distance? Người đọc phải đoán, mà đoán sai thì toang.

✔️ Good:

const currentDate = new Date();

• Không cần comment.
• Không cần giải thích.
• Tên tự nói lên chức năng của nó.

Nguyên tắc nhỏ:

• Tên phải mô tả ý nghĩa, không phải kiểu dữ liệu
• Đừng viết tắt trừ khi viết tắt đó quá nổi tiếng (e.g., id, url)
• Biến boolean nên bắt đầu bằng is, has, can, should

2. Hàm ngắn, làm đúng một việc (Single Responsibility)

Một hàm tốt giống như một công nhân chăm chỉ: Chỉ làm đúng trách nhiệm của nó — và làm thật tốt.

Nếu bạn thấy một hàm:

• Dài hơn 30–40 dòng
• Đổi trạng thái lung tung
• Xử lý nhiều logic khác nhau
• Hoặc bạn phải scroll 3 lần mới thấy hết…

=> 90% là nó đang ôm việc quá mức.

❌ Bad:

function handleUser() {
  // validate form
  // call API
  // format data
  // update UI
}

Đây không phải handleUser, mà là "làm tất cả mọi thứ trên đời".

✔️ Good:

function validateUserForm(form) { /* ... */ }
function submitUserData(data) { /* ... */ }
function updateUserUI(response) { /* ... */ }

Hàm nhỏ = dễ test, dễ sửa, dễ mở rộng.

3. Code cho con người, không phải cho máy (Readable Over Clever)

Máy tính thì nhanh, còn não người thì… không.

Đừng cố viết code "ngầu" hoặc "bá đạo" để chứng minh trình độ, vì:

Code clever hôm nay là code khó hiểu ngày mai.

❌ Bad (ngầu nhưng đau đầu):

const result = arr.filter(x => !~blacklist.indexOf(x));

Không ai hiểu nổi !~ ngay lần đầu.

✔️ Good (ít ngầu nhưng rõ ràng):

const result = arr.filter(item => !blacklist.includes(item));

Clean Code không phải là viết code fancy. Clean Code là viết code dễ đọc nhất có thể.

Kết luận

Clean Code không phải một bộ quy tắc cứng nhắc. Nó là tư duy: viết code nhân văn, có trách nhiệm, tôn trọng người đọc.

3 nguyên tắc bạn có thể áp dụng ngay:

1. Đặt tên rõ ràng – để người khác không phải đoán.
2. Hàm nhỏ và làm một việc – để dễ sửa, dễ test.
3. Ưu tiên dễ đọc – vì người bảo trì code có thể chính là bạn.

Viết code sạch không chỉ giúp team bạn vui hơn mà còn khiến bạn trở thành một developer chất lượng hơn mỗi ngày.