Clean Code là gì?

NỘI DUNG BÀI VIẾT

Chào các bạn, trong bài viết này mình sẽ chia sẻ một số kiến thức về Clean Code. Hãy cùng mình tìm hiểu Clean Code là gì và tại sao phải sử dụng chúng nhé.

Clean Code là thuật ngữ để chỉ những mã nguồn tốt bao gồm các đặc điểm:

Đơn giản: Giải quyết vấn đề ngắn gọn, không phức tạp hóa.
Trực tiếp: Giải quyết đúng vấn đề đang đề cập đến.
Dễ đọc: Giúp các lập trình viên khác có thể hiểu được ý nghĩa của từng dòng code dễ dàng.
Dễ cải tiến: Có thể mở rộng, thay đổi mà không gây ra nhiều lộn xộn cho mã nguồn.
Có Unit Test và Acceptance: Đảm bảo mã nguồn chạy đúng với từng trường hợp.
Định danh tốt: Thể hiện đúng ý nghĩa từng thành phần.
Có ít sự phụ thuộc: Giúp thay đổi và mở rộng dự án dễ dàng hơn.
Không có mã nguồn trùng lặp.
Thể hiện được ý tưởng của thiết kế: Bảo đảm được đúng với ý tưởng thiết kế.

Tại sao chúng ta phải sử dụng Clean Code?

Để đảm bảo mã nguồn có chất lượng tốt, giúp ích cho việc cộng tác nhóm, dễ dàng bảo trì và mở rộng hệ thống.

Một số yếu tố ảnh hưởng tới Clean Code

1. Định danh:

Biến, hàm, lớp, package phải ngắn gọn, thể hiện được ý nghĩa. Không đặt tên chung chung, khó hiểu.

Mã nguồn không tốt: a, x, data, get …
Mã nguồn tốt: nameStudent, getName …

2. Hàm:

Hàm không quá dài, làm nhiều nhiệm vụ, có nhiều tham số.

Mã nguồn không tốt:

int calculator(int number1, int number2, int number3, int number4){
     ...
}

Hàm trên đặt tên hàm không rõ ràng và có quá nhiều tham số.

Mã nguồn tốt:

int calculatorSum(int number1, int number2)
{
     ...
}

Hàm trên đặt tên rõ ràng và có ít hơn 3 tham số.

Ghi chú: Không nên lạm dụng ghi chú quá nhiều, không đúng mục đích.

3. Định dạng mã nguồn (Format):

Như các khoảng cách lùi đầu dòng, dẫn cách giữa các từ, các lệnh không hợp lý,…

4. Thiết kế, kiến trúc tồi:

Thiết kế ẩu, không rõ ràng, tường minh, người khác đọc vào không hiểu khiến cho việc bảo trì, tái cấu trúc, nâng cấp trở nên khó khăn.

5. Thiếu các bản kiểm thử:

Dẫn đến không đảm bảo được chất lượng mã nguồn ổn định.

Một số quy ước đặt tên nên biết:

Tên biến, lớp: Nên đặt tên là các danh từ, cụm danh từ hay tính từ.
Tên hàm: Nên bắt đầu bằng động từ.
Tên biến và hàm nên theo quy tắc camelCase: Ký tự đầu tiên viết thường, các ký tự đầu tiên của từ sau viết hoa.
Tên lớp nên theo quy tắc Pascal Case: Viết hoa hết các ký tự đầu tiên của chữ đó.

Ví dụ:

Biến: nameStudent, listNameStudent,…

Lớp: Animal, Student, Person, Dog,…

Hàm: searchByName(), getName(), sortByPrice(),…

Clean Code là gì?