Clean code là gì? làm sao để viết code clean?

Clean code là một trong những thủ thuật mà một coder mới hay cũ đều nên biết để có thể nâng cao trình độ Code của mình. Thủ thuật này khá phổ biến nhưng không phải ai cũng chú ý về nó.

1. Đặc điểm của Clean code

• Source Code phải thanh lịch: Hãy hình dung đến 2 chữ “thanh lịch”, nó phải sạch sẽ, cảm thấy hứng thú khi đọc. Giống như khi bạn chăm chú đọc một bài văn hay vậy 
• Code phải có tâm điểm (focus): Mỗi fucntion, mỗi class, mỗi module chỉ thực hiện một chức năng duy nhất, không bị phân tán, bởi các context xung quanh.
• Clean code thì được trau chuốt, người code ra nó đã dành thời gian đển giữ cho nó đơn giản và có trật tự nhất có thể.
• Chạy tốt trên tất cả các case : Đôi khi các function được tạo ra chỉ chạy tốt trên các case bình thường, còn các case “quái dị” thì xảy ra lỗi.
• Tối ưu số lượng các class, method, function …

Trên đây là những đặc điểm tiêu biểu của Clean code, vậy code thể nào để được những điều này?

2. Đặt tên có ý nghĩa

Chọn một cái tên tốt cho source code có lẽ sẽ tốn thời gian, nhưng nó còn đỡ hơn nhiều so với việc phải đọc toàn bộ code mới có thể hiểu được nó có chức năng gì phải không nào ? Tên của một biến, hàm, class sẽ trả lời được các câu hỏi quan trọng như “nó làm gì? “, “tại sao nó tồn tại? ” và “cách nó được sử dụng? “.

• Class name: các class và các object nên có tên là danh từ hoặc cụm danh từ như Customer, Account, Client,… Tránh cách từ như Manager, Processor, Data hoặc chứa thông tin trong tên của một class. Một tên class không nên là một động từ.
• Method name: nên được bắt đầu bằng một động từ hoặc một cụm động từ như postPayment(), deleteUser() , hoặc saveScore(). Các method dùng để access vào các trường trong class thì nên được tên theo tên trường đó và đước trước là set/get. Ví dụ Class User có trường là name. Thì các method để đọc và ghi dữ liệu cho 2 trường này sẽ là setName(…) , getName().

Cùng xem đoạn code sau để thấy sự quan trọng của việc đặt tên biến:

Viết thế này 1 thời gian sau nhìn lại bạn có thể chẳng hiểu gì. Cũng là một function nhưng được đặt tên biến, fucntion một cách đàng hoàng:

Các bạn có thể thấy rõ sự khác nhau khi đọc hiểu phải không nào.

• Pick one word per concept: Chọn một từ cho một function trừu tượng gắn với nó (abstract funtion). Hơi khó hiểu một chút. Chẳng hạn khi một class kế thường nhiều các interface, mà trong các interface đó lại có nhiều các abstract funtion thì làm sao mà chúng ta có thể biết được method nào là của interface nào mà triển khai cho đúng logic. Và giải pháp ở đây là chọn một từ (danh từ) giống với class/interface chứa abstract funtion đó. Ví dụ interface : ActionPostListener thì abstract fun của nó là savePost(), sharePost, deletePost()…

3.    Function:

Nguyên tắc đầu tiên cho một function là nó phải nhỏ nhất có thể, giải quyết một vấn đề duy nhất, khi nào cần thì gọi. Điều này giúp cho việc đọc code và tái sử dụng của nó trở nên dễ dàng hơn rất nhiều.

Function arguments:

• Một function không nên có nhiều hơn 3 tham số truyền vào. Khi một function dường như cần nhiều hơn 2 hoặc 3 argument, chúng ta nên gói nó vào trong một class hoặc struct của riêng nó. Việc giảm số lượng argument truyền vào có vẻ như là “ăn gian” nhưng không phải. Điều này sẽ giúp cho class ngắn gọn và dễ hiểu hơn. Ví dụ như chúng ta có một function là ăn()các tham số truyền vào có lẽ là “món chính”, “món phụ”, “canh”, “nước chấm”, “món tráng miệng”… dài quá, chỉ cần đơn giản gói nó vào class là Food, trong Food này sẽ định nghĩa các trường trên và truyền vào. Xong!

Tránh hard code

• Hãy đặt tên cho các giá trị là số, string một cách ý nghĩa, điều này có thể tránh được cảm giác khó hiểu cho người đọc code như “giá trị này là gì?”, “nó chui từ đâu ra” ?… Ví dụ:

Nhìn vào chả hiểu gì phải không nào. giá trị 5, 10 là gì? 75 ?… Và sau khi “làm đẹp”

• Có thể cần phải code dài hơn, nhưng rõ ràng là dễ hiểu hơn nhều đúng không, vì thế nên hãy định nghĩa mọi thứ.

4. Tái sử dụng:

Trong một dự án thực tế, đôi khi có rất nhiều các sự trung lặp về logic, các instance. Cứ mỗi lần sử dụng những thứ này lại phải đi định nghĩa lại chúng sẽ tốn rất nhiều thời gian, lãng phí efford và duplicate code. Hãy tối ưu những fucntion, logic để có thể tái sử dụng lại ở nhiều nơi. Nếu trong một class sử dụng nhiều đoạn logic giống nhau, hãy tách logic đó ra thành một method và ở đâu cần sử dụng chỉ cần gọi method đó. Còn trong một dự án tái sử dụng một method nhiều lần hãy tạo ra một public constant, đưa method đó vào. Nơi nào cần nơi đó gọi.

Via Topdev