Clean Code — Phần 1: Đặt tên và Hàm

Tại sao đặt tên quan trọng?

Đặt tên là một trong những kỹ năng quan trọng nhất trong lập trình. Tên biến, hàm, class phải thể hiện rõ ý định của người viết.

Quy tắc đặt tên

• Tên có ý nghĩa: Tránh đặt tên như d, temp, data. Thay vào đó dùng elapsedTimeInDays, temporaryFile.
• Tránh thông tin sai: Đừng dùng accountList nếu không phải là List.
• Phân biệt có ý nghĩa: getActiveAccount() và getActiveAccountInfo() khác nhau thế nào?

// Bad
const d = new Date();
const n = users.length;

// Good
const currentDate = new Date();
const totalUsers = users.length;

Viết hàm sạch

Hàm nên ngắn gọn và chỉ làm một việc duy nhất.

Nguyên tắc

1. Nhỏ: Hàm lý tưởng không quá 20 dòng
2. Một việc: Mỗi hàm chỉ thực hiện một nhiệm vụ
3. Một mức trừu tượng: Không trộn lẫn các mức trừu tượng trong một hàm

// Bad - làm quá nhiều việc
function processUser(user: User) {
  // validate
  if (!user.email) throw new Error("Missing email");
  // save
  db.save(user);
  // send email
  mailer.send(user.email, "Welcome!");
}

// Good - tách thành các hàm nhỏ
function processUser(user: User) {
  validateUser(user);
  saveUser(user);
  sendWelcomeEmail(user);
}

Kết luận phần 1

Đặt tên tốt và viết hàm sạch là nền tảng của code dễ đọc, dễ bảo trì.