Cách đặt tên biến trong TypeScript như thế nào?

Question

Niềm Đam Mê · Accepted Answer

Đặt tên biến trong TypeScript là một bước quan trọng để đảm bảo mã nguồn dễ đọc, dễ bảo trì, và tránh nhầm lẫn khi làm việc nhóm hoặc sau một thời gian dài. Việc đặt tên biến không chỉ ảnh hưởng đến tính nhất quán của dự án mà còn giúp phản ánh chính xác ý nghĩa và vai trò của từng biến trong chương trình.
Trong TypeScript, các quy tắc đặt tên biến thường tuân theo các quy ước chuẩn của JavaScript, nhưng có thể có những điều chỉnh nhất định để phù hợp với các tính năng như kiểu tĩnh và lập trình hướng đối tượng.
Quy tắc chung khi đặt tên biến trong TypeScript
1. Tên biến phải rõ ràng và có ý nghĩa
Tên biến nên mô tả rõ ràng mục đích của nó trong chương trình. Tránh sử dụng tên biến ngắn gọn hoặc không có ý nghĩa (như a, x, temp,&#8230;) mà không có lý do rõ ràng. Tên biến càng mô tả rõ ràng vai trò của nó, mã của bạn sẽ càng dễ hiểu.
Ví dụ:
let x = 10; // Tên biến không rõ ràng
let age = 10; // Tên biến rõ ràng hơn, mô tả rõ nội dung là độ tuổi
2. Sử dụng quy tắc camelCase
TypeScript và JavaScript thường tuân theo quy tắc camelCase cho việc đặt tên biến. Quy tắc này yêu cầu chữ cái đầu tiên của biến viết thường và chữ cái đầu tiên của các từ tiếp theo viết hoa.
Ví dụ:
let firstName = "John"; // Sử dụng camelCase
let lastName = "Doe"; // Sử dụng camelCase
3. Tránh sử dụng từ khóa đặc biệt
TypeScript và JavaScript có một số từ khóa dành riêng (reserved keywords) mà bạn không thể sử dụng để đặt tên biến, ví dụ: let, const, if, else, for, class, function, v.v. Sử dụng những từ khóa này làm tên biến sẽ gây ra lỗi cú pháp.
let class = "Programming"; // Sai vì class là từ khóa đặc biệt
4. Không bắt đầu tên biến bằng số
Trong TypeScript, tên biến không được phép bắt đầu bằng số. Nếu bạn cần thể hiện một giá trị số trong tên biến, hãy để số ở phía sau hoặc dùng từ để mô tả.
let 2ndPlace = "Silver"; // Sai
let secondPlace = "Silver"; // Đúng
5. Tránh sử dụng các ký tự đặc biệt
Tên biến chỉ nên bao gồm các ký tự chữ cái, số, và ký tự dấu gạch dưới (_). Tránh sử dụng các ký tự đặc biệt như !, @, #, &,&#8230; vì chúng có thể gây nhầm lẫn và khó hiểu.
Ví dụ:
let user!name = "John"; // Sai
let user_name = "John"; // Đúng nhưng không phải là cách đặt tên phổ biến (nên dùng camelCase hơn)
6. Sử dụng từ khóa let hoặc const thay vì var
Trong TypeScript, bạn nên sử dụng let hoặc const thay vì var để khai báo biến, bởi vì let và const có phạm vi khối (block scope) và an toàn hơn khi làm việc với các luồng logic phức tạp.
let: Dùng cho những biến có thể thay đổi giá trị.
const: Dùng cho những biến không thể thay đổi giá trị sau khi khởi tạo.
let age = 30; // Sử dụng let cho biến có thể thay đổi
const birthYear = 1990; // Sử dụng const cho biến không thay đổi
7. Sử dụng tên biến nhất quán
Hãy đảm bảo tính nhất quán trong cách bạn đặt tên biến xuyên suốt dự án. Nếu bạn sử dụng camelCase cho tên biến, hãy giữ quy tắc này trong toàn bộ mã. Điều này sẽ giúp mã của bạn dễ đọc và duy trì.
Đặt tên biến trong các ngữ cảnh cụ thể
1. Đặt tên biến cho các kiểu dữ liệu nguyên thủy
Khi làm việc với các kiểu dữ liệu nguyên thủy như string, number, boolean, bạn nên đặt tên biến phản ánh đúng loại giá trị mà chúng lưu trữ.
let isActive: boolean = true; // Đặt tên biến boolean bắt đầu bằng "is" hoặc "has"
let userAge: number = 25; // Đặt tên rõ ràng cho số tuổi
let userName: string = "Alice"; // Đặt tên mô tả đúng kiểu dữ liệu chuỗi
2. Đặt tên biến trong các đối tượng và lớp
Trong lập trình hướng đối tượng, việc đặt tên biến cho các thuộc tính và phương thức cũng cần tuân theo các quy tắc như trên. Tên thuộc tính và phương thức cần rõ ràng, sử dụng camelCase và có ý nghĩa mô tả chức năng.
class User {
  firstName: string;
  lastName: string;
  
  constructor(firstName: string, lastName: string) {
    this.firstName = firstName;
    this.lastName = lastName;
  }
  getFullName(): string {
    return `${this.firstName} ${this.lastName}`;
  }
}
let user = new User("John", "Doe");
console.log(user.getFullName()); // John Doe
3. Đặt tên biến trong các hàm
Đặt tên cho các tham số trong hàm cũng quan trọng không kém. Tên tham số nên phản ánh chức năng của chúng, đồng thời giúp người đọc hiểu được hàm đang làm gì mà không cần phải xem chi tiết bên trong.
function calculateArea(width: number, height: number): number {
  return width * height;
}
let area = calculateArea(10, 5);
console.log(area); // 50
4. Đặt tên biến cho hằng số
Đối với các hằng số, một quy tắc phổ biến là sử dụng tên viết hoa và các từ cách nhau bằng dấu gạch dưới (_). Điều này giúp phân biệt hằng số với các biến thông thường.
const MAX_USERS = 100;
const API_URL = "https://api.example.com";
Kết luận
Việc đặt tên biến trong TypeScript không chỉ là một quy ước, mà còn là cách để làm cho mã nguồn trở nên dễ đọc và dễ duy trì. Sử dụng tên biến rõ ràng, nhất quán, và có ý nghĩa giúp giảm thiểu lỗi và cải thiện khả năng làm việc nhóm. Khi tuân thủ các quy tắc như sử dụng camelCase, tránh sử dụng các từ khóa đặc biệt, và chọn đúng loại từ khóa khai báo (let hoặc const), bạn sẽ tạo ra mã sạch và an toàn hơn trong TypeScript.