12 Nguyên Tắc Vàng Đặt Tên Biến Trong JavaScript

Khi viết mã JavaScript, việc tổ chức mã một cách rõ ràng và dễ hiểu là rất quan trọng. Một trong những yếu tố quyết định sự dễ đọc và khả năng bảo trì của mã nguồn chính là cách bạn đặt tên biến. Dưới đây là 12 nguyên tắc vàng giúp bạn cải thiện cách đặt tên biến trong JavaScript:

---

1. Tránh Sử Dụng Từ Khóa var: Quá Khứ Đã Qua

• Từ khóa var đã từng phổ biến trước khi ES6 ra đời, nhưng nó có nhiều hạn chế dễ gây ra lỗi.
• Hãy sử dụng let và const thay cho var để viết mã rõ ràng hơn và tránh lỗi không mong muốn.

---

2. Sử Dụng let Khi Biến Có Thể Thay Đổi

• Chọn let cho những biến có giá trị có thể thay đổi trong suốt quá trình thực thi.

---

3. Sử Dụng const Cho Các Giá Trị Không Thay Đổi

• Hãy dùng const cho những biến không thay đổi giá trị để đảm bảo tính nhất quán trong mã.
• Quy tắc đơn giản: luôn sử dụng const trừ khi bạn chắc chắn rằng biến cần thay đổi.

---

4. Đặt Tên Biến Rõ Ràng và Dễ Hiểu

• Tên biến cần phải phản ánh chính xác mục đích và nội dung mà nó lưu trữ.
  ✅ Ví dụ Tốt: firstName, totalPrice, productDescription
  🔴 Ví dụ Không Tốt: x, a, temp

---

5. Sử Dụng Từ Ngữ Có Nghĩa

• Tránh viết tắt hoặc dùng các thuật ngữ quá kỹ thuật có thể làm cho mã trở nên khó hiểu.
  ✅ Ví dụ Tốt: customerName, orderStatus, employeeRecord
  🔴 Ví dụ Không Tốt: custNm, ordSt, empRec

---

6. Quy Tắc Camel Case

• Hãy viết hoa chữ cái đầu của mỗi từ trong tên biến, trừ từ đầu tiên.
  ✅ Ví dụ Tốt: fullName, dateOfBirth, shippingAddress
  🔴 Ví dụ Không Tốt: full_name, dateofbirth, shipping_address

---

7. Viết Hoa Cho Biến Hằng Số

• Với những biến lưu trữ giá trị cố định, hãy viết hoa toàn bộ và dùng dấu gạch dưới để phân cách từ.
  ✅ Ví dụ Tốt: TAX_RATE, API_KEY, MAX_ATTEMPTS
  🔴 Ví dụ Không Tốt: taxRate, apiKey, maxAttempts

---

8. Tránh Dùng Biến Một Ký Tự

• Tên biến một ký tự có thể gây khó hiểu, trừ khi trong một số vòng lặp.
  ✅ Ví dụ Tốt: counter, index, sum
  🔴 Ví dụ Không Tốt: i, j, k

---

9. Sử Dụng Tên Dạng Số Nhiều Cho Mảng

• Đối với biến đại diện cho một mảng, hãy dùng tên số nhiều.
  ✅ Ví dụ Tốt: productNames, orderItems, employeeList
  🔴 Ví dụ Không Tốt: productName, orderItem, employee

---

10. Tiền Tố Cho Biến Boolean

• Biến Boolean nên có các tiền tố như is, has, can để làm rõ bản chất của biến.
  ✅ Ví dụ Tốt: isActive, hasDiscount, canEdit, isLoggedIn
  🔴 Ví dụ Không Tốt: active, discountApplied, editEnabled, loggedIn

---

11. Đặt Tên Theo Phạm Vi Biến

• Nếu biến chỉ sử dụng trong một phạm vi cụ thể, hãy thêm tiền tố hoặc hậu tố để thể hiện rõ phạm vi sử dụng.
  ✅ Ví dụ Tốt: globalCounter, localIndex, moduleSpecificConfig
  🔴 Ví dụ Không Tốt: counter, index, config

---

12. Khai Báo Biến Riêng Lẻ

• Để mã nguồn dễ đọc hơn, hãy khai báo mỗi biến trên một dòng riêng.
  ✅ Ví dụ Tốt: let isActive = false; let canEdit = true;
  🔴 Ví dụ Không Tốt: let isActive = false, canEdit = true;

---

Kết Luận:

Việc tuân theo 12 nguyên tắc này sẽ giúp bạn tạo ra mã nguồn JavaScript dễ đọc, dễ bảo trì và hạn chế lỗi không mong muốn. Hãy xây dựng cho mình một quy tắc đặt tên và kiên định tuân thủ để dự án trở nên chuyên nghiệp hơn và dễ dàng hợp tác với đồng đội.

Cảm ơn bạn đã đọc bài viết của mình và mong rằng những chia sẻ này sẽ hữu ích cho bạn trong quá trình lập trình! Hãy theo dõi mình để nhận thêm những bài viết giá trị khác nhé!
source: viblo