NỘI DUNG BÀI VIẾT
Coding Convention là gì?
Coding Convention là tập hợp những nguyên tắc chung khi lập trình nhằm làm cho code dễ đọc, dễ hiểu, do đó dễ quản lý, bảo trì hơn.
Coding Convention có những cái chung và cái riêng tuỳ ngôn ngữ, tuỳ cộng đồng, nhưng hầu hết được công nhận và đi theo bởi đa số các lập trình viên trên thế giới.
Quy tắc đặt tên (naming convention)
Cú pháp lạc đà (camelCase)
Ký tự đầu tiên của từ đầu tiên viết thường những ký tự đầu tiên của những từ tiếp theo được viết hoa.
Ví dụ: productPrice, camelCasing, thisIsTheNameThatFollowTheCamelCase
Cú pháp Pascal (PascalCase)
Cú pháp Pascal viết hoa chữ cái đầu tiên của mỗi từ.
Ví dụ: ProductName, PascalCasing, ThisIsTheNameThatFollowThePascalCase
Cú pháp con rắn (SNAKE_CASE)
Với cú pháp con rắn, tất cả các chữ cái đều viết thường, và các từ cách nhau bởi dấu gạch dưới.
Ví dụ: user_name, this_is_the_name_that_follow_the_snake_case
Việc sử dụng cú pháp nào là tuỳ vào mỗi ngôn ngữ, mỗi cộng đồng định nghĩa, nhưng chung quy đều dùng ba cú pháp này, và kèm theo các nguyên tắc:
- Tên lớp thì đặt theo PascalCase
- Tên biến, tên hàm đặt theo camelCase hoặc snake_case
- Hằng số đặt theo UPPER_CASE, ví dụ: CLICK_COUNTER
- Tên biến, tên lớp thường là danh từ, cụm danh từ hoặc tính từ: UserModel, userName, downloadCounter, isDownloaded
- Tên hàm thường bắt đầu bằng động từ: getUserName, setUserModel, increaseDownloadCounter
- Tên thì phải có nghĩa, KHÔNG ĐƯỢC đặt tên kiểu viết tắt (dlCounter, uName, idl, a, a1, doFA)
- Tránh đặt những tên quá chung chung, tối nghĩa: top, best, doIncrease, getAll
Quy tắc về số lượng
Bob Martin phát biểu trong cuốn Clean Code: “if small is good, then smaller must be better”.
Số lượng dòng code trong hàm/lớp, số lượng hàm trong lớp, số lượng lớp trong gói phải giữ ở một giới hạn nhất định nào đó, và nên giữ càng ít càng tốt, ví dụ:
- Hàm không nên quá 30 dòng (Martin Lippert-rule 30)
- Lớp không nên vượt quá 500 dòng (Clean Code)
- Một hàm không được vượt quá 5 tham số, (nên giữ <=3)(Clean Code)
- Một hàm chỉ làm duy nhất 1 việc, trong trường hợp chính đáng, làm 2 việc cũng được phép, tuy nhiên tên hàm phải nói rõ điều này, vd: increaseDownloadCounterAndSaveToDatabase
- Khi khai báo biến, một dòng chỉ chứa một biến
- Một dòng không nên dài quá 80 ký tự (Oracle)
- Các câu lệnh lồng nhau tối đa 4 cấp
Quy tắc xuống hàng
Theo Oracle
- Nếu có dấu phẩy thì xuống hàng sau dấu phẩy (,)
- Xuống hàng trước toán tử +, – …
- Nếu có nhiều cấp lồng nhau, thì xuống hàng theo từng cấp
- Dòng xuống hàng mới thì nên bắt đầu ở cùng cột với đoạn lệnh cùng cấp ở trên.
Comment
- Hạn chế dùng comment để giải thích code, thay vào đó hãy cải thiện đoạn code.
- Chỉ nên dùng comment trong trường hợp viết documentation cho thư viện, thông tin đính kèm cho class…
Kết luận
Coding Convention là yếu tố cực kỳ quan trọng khi bạn muốn trở thành một lập trình viên chuyên nghiệp. Hãy bắt đầu code có ý thức từ ngay bây giờ, kể cả với những project cá nhân. Bởi việc rèn luyện coding convention khiến bạn trở thành người sống có quy tắc và kiên nhẫn hơn trong công việc.
Việc đọc code của bản thân hay người khác sẽ không phải là một điều khó khăn nữa nếu ai cũng biết các quy tắc và áp dụng nó thành công. Cảm ơn bạn đã theo dõi bài viết!
Các bạn có thể tham khảo các bài viết hay về JavaScript tại đây.
Hãy tham gia nhóm Học lập trình để thảo luận thêm về các vấn đề cùng quan tâm.
