Chủ Nhật, Tháng Một 29, 2023
24 C
Ho Chi Minh City
spot_img

Code Convention là gì? Tổng hợp những quy tắc chung khi viết Code – Hành trang Lập trình blog

Must read

Openlivenft
Openlivenfthttps://openlivenft.info/
Trang tổng hợp thông tin nhanh - mới nhất về NFT, COIN, Metaverse, tài chính, crypto của OpenliveNFT
Viết Code là một hoạt động giải trí không hề tránh khỏi khi bạn trở thành một lập trình viên. Tuy nhiên, để viết “ Code sạch, Code đẹp ” sao cho cả đội nhóm cùng hiểu là một yếu tố không hề triển khai trong “ một sớm một chiều ”. Vì thế, Code Convention là một điều thiết yếu để giúp Code của bạn tốt hơn. Vậy, Code Convention là gì ? Những quy tắc chung khi viết Code ra làm sao ?

Tìm hiểu về Code Convention

Code Convention là gì?

Code Convention được tạm dịch là quy ước viết Code. Có thể hiểu một cách đơn giản, Code Convention là một tập hợp các quy ước về cách để viết Code, đặt tên biến, class, hàm, file và rất nhiều quy tắc khác như thụt đầu dòng, comment, cách “.” cách “,”,… để cho các khối Code trở nên “clean” hơn.

Trong một dự án ứng dụng lớn, khi hàng loạt lập trình viên của dự án đều tuân theo một quy tắc viết Code, giúp việc tiếp xúc giữa những thành viên trở nên thuận tiện hơn. Dự án cũng sẽ hoàn toàn có thể thêm những module công dụng nhanh gọn hơn, việc bảo dưỡng và tăng trưởng mạng lưới hệ thống sau này cũng sẽ thuận tiện hơn .
code-convention-la-gi

Tại sao nên sử dụng Code Convention?

Khi Code có Convention, hay Code theo quy tắc chung mà mọi người đều biết, điều này sẽ giúp cho hoạt động làm việc theo nhóm trở nên dễ dàng hơn. Trừ một số trường hợp đặc biệt, thông thường, một dự án phần mềm không thể được hoàn thiện chỉ với một cá nhân mà sẽ được thực hiện theo nhóm. Nếu mỗi người viết một phong cách khác nhau, những người còn lại sẽ “gai mắt” hoặc không hiểu bạn đang viết gì.

Vì thế, việc Code theo một quy ước chung sẽ giúp cho cả nhóm thao tác trơn tru hơn, hiểu nhau hơn và giảm thiểu thực trạng những câu hỏi như : “ Bạn viết cái gì vậy ! ” “ Cái này là cái gì vậy bạn hiền ? ”, …
Vậy, khi Code Convention tất cả chúng ta sẽ có những quyền lợi như sau :

  • Giúp làm việc nhóm hiệu quả hơn
  • Thống nhất và tuân thủ theo một chuẩn dễ dàng làm việc hơn
  • Giúp người khác nắm bắt Code bạn viết nhanh hơn
  • Dễ dàng nâng cấp và cải tiến phần mềm
  • Có thể tái sử dụng trong nhiều phần mềm khác nhau
  • Thuận lợi trong việc phát triển và bảo trì hệ thống sau này

Tổng hợp những quy tắc chung khi viết Code

Naming Convention – quy tắc đặt tên

Một trong những việc khiến người khác có thể hiểu Code của bạn viết gì là thông qua: cách đặt tên các biến, hằng, class,… có thể gọi chung là định danh.

Khi triển khai một bài tập nhỏ lúc bạn học tin học cấp 3 hay những bài tập giải thuật đơn thuần, tất cả chúng ta được chỉ cách đặt tên biến là a, b, c, d. Tuy nhiên, điều này chỉ vận dụng cho những bài tập cấp thấp và không có quá nhiều tính năng .
Hãy tưởng tượng, một ứng dụng khổng lồ như Windows với cả ngàn công dụng, liệu việc đặt tên a-b-c-d sẽ hiệu suất cao trong việc tăng trưởng ? Không hề ! Nếu bạn đang học ĐH / cao đẳng / tầm trung và những thầy cô dạy vẫn chưa nói gì về đặt tên những hàm, những biến, sớm thôi họ cũng sẽ nhắc nhở bạn đấy !
Chúng ta sẽ có những cách đặt tên thông dụng như sau :

  • Cú pháp lạc đà – camelCase
  • Cú pháp Pascal – PascalCase
  • Cú pháp con rắn – snake_case

Tùy theo ngôn từ sẽ có một cách để sử dụng cú pháp riêng, nhưng bạn hoàn toàn có thể tìm hiểu thêm những ví dụ sẽ được nêu ngay sau đây nhé !
Trong hầu hết những công ty ứng dụng trong nước hay ngoài nước, quy tắc đặt định danh đều sẽ được mặc định là sử dụng tiếng Anh .
code-convention-la-gi

Cú pháp lạc đà – camelCase

Cú pháp lạc đà là cú pháp có cách viết từ tiên phong của cụm sẽ là viết thường và ký tự của những từ tiếp theo sẽ được viết hoa .

Thông thường, cú pháp này sẽ được dùng để viết các hàm, tên biến, phương thức.

Ví dụ về phương pháp, hàm : firstName, lastName, runLow ( ), getOnTop ( ), …
Ví dụ về biến : int i ; float spaceX, …

Cú pháp Pascal – PascalCase

Cú pháp Pascal là cú pháp sẽ được viết theo dạng viết hoa tổng thể những ký tự tiên phong trong từ của cụm .

Bạn có thể thấy việc này quá quen thuộc khi học Pascal lúc cấp 3, khi gõ lại bài tập từ một “thanh niên” nào đó “cứu” cả lớp đúng chứ? Thông thường, cú pháp này được sử dụng cho tên class, đôi khi là cả tên biến.

Ví dụ : class Mice, class MickeyMouse, …

Cú pháp con rắn – snake_case

Cú pháp con rắn sẽ có cách viết thông dụng là hàng loạt vần âm đều viết thường và tách nhau ra bằng dấu gạch dưới “ _ ”. Trong một vài trường hợp, một vài ngôn từ, tất cả chúng ta có biến thể là viết hàng loạt những vần âm đều in hoa .

Thông thường, chúng ta sẽ nhìn thấy cú pháp này trong việc đặt tên hằng và đôi khi là tên chương trình.

Ví dụ như : MAX_SLECT, final_final1_final2, …
code-convention-la-gi

Ngoài ra, trong lúc đặt tên chúng ta còn cần phải lưu ý thêm:

  • Tên class, tên biến thường sử dụng danh từ
  • Tên hàm sẽ thường bắt đầu bằng động từ
  • Nên đặt tên theo kiểu gợi nhớ đến chức năng của chúng
  • Bạn không nên đặt tên theo kiểu viết tắt. Trong tương lai khi đọc lại Code bạn sẽ không hiểu hiện tại bạn đang viết gì
  • Tránh đặt tên theo kiểu chung chung không có ý nghĩa

Quy tắc số lượng

Một số quy tắc về số lượng trong cuốn sách Clean Code A Handbook of Agile Software Craftsmanship của Robert C. Martin, quyển Refactoring in Large Software Projects : Performing Complex Restructurings Successfully của Martin Lippert cũng như bộ quy tắc của Oracle có ghi như sau :

  • Một dòng Code không nên dài quá 80 ký tự
  • Một câu lệnh nên lồng tối đa 4 cấp
  • Một hàm không nên chứa quá 5 tham số
  • Một hàm không nên quá 30 dòng
  • Một class không nên vượt 500 dòng

Quy tắc comment – bình luận

  • Bạn nên tránh sử dụng comment để giải thích Code, việc hoàn thiện đoạn Code bằng như quy tắc đặt tên sẽ giúp Code của bạn dễ hiểu hơn.
  • Nếu bạn là người mới hoặc mau quên, việc sử dụng comment để giải thích việc mình làm với đoạn Code cũng là một ý hay đấy!

Quy tắc xuống hàng

Theo bộ quy tắc của Oracle, tất cả chúng ta có :

  • Nếu một hàm có nhiều cấp lồng nhau, mỗi cấp chúng ta nên xuống dòng.
  • Các đoạn Code bằng cấp nên ở cùng một cột với nhau, dòng xuống hàng nên bắt đầu cùng cấp với dòng phía trên.
  • Xuống hàng trước các toán tử ví dụ như: +, -, *, ?,…

Tham khảo : https://wiki.tino.org/code-convention-la-gi/

Source: https://openlivenft.info
Category: TIN NFT

Đánh giá bài post
- Advertisement -spot_img

More articles

LEAVE A REPLY

Please enter your comment!
Please enter your name here

- Advertisement -spot_img

Latest article

Ethereum là gì? | OpenliveNFT