Minh họa cho Quy tắc Hướng đạo sinh
Law #4 Chất lượng

Quy tắc Hướng đạo sinh

The Boy Scout Rule

Mỗi lần chạm vào code, hãy để nó sạch hơn, rõ hơn hoặc an toàn hơn một chút so với trước đó.

Nguồn tham khảo: Laws of Software Engineering

Tổng quan

Quy tắc Hướng đạo sinh trong phần mềm nhắc rằng mỗi lần chạm vào code, ta nên để khu vực đó tốt hơn một chút. Nó chống lại kiểu bỏ mặc các vết bẩn nhỏ cho đến khi codebase trở nên khó cứu.

Ý chính

  • Cải thiện nhỏ có thể là đổi tên rõ hơn, tách hàm dài, xóa code chết hoặc làm test dễ hiểu hơn.
  • Giữ code sạch là hoạt động liên tục, không phải một dự án rewrite khổng lồ thỉnh thoảng mới làm.
  • Khi cả team cùng làm, codebase hình thành văn hóa ownership thay vì tâm lý "không phải việc của tôi".

Ví dụ từ nguồn

Khi thêm feature vào module cũ, bạn có thể tách một hàm 200 dòng thành vài hàm nhỏ hơn và xóa các comment TODO đã lỗi thời ngay trong phạm vi đang sửa.

Một bugfix nhỏ có thể đi kèm test regression cho đúng lỗi đó, giúp khu vực vừa chạm trở nên an toàn hơn.

Nguồn gốc

Câu "leave the campsite cleaner than you found it" đến từ phong trào Hướng đạo. Trong phần mềm, quy tắc này được phổ biến mạnh bởi Robert C. Martin và cộng đồng clean code.

Lưu ý khi áp dụng

Giữ phạm vi cải thiện nhỏ và liên quan trực tiếp đến phần đang chạm; đừng biến một task nhỏ thành refactor lan rộng.

← Quay lại danh sách 56 luật