Viết TypeScript sạch và dễ bảo trì

TypeScript phát huy giá trị tốt nhất khi giúp chúng ta mô hình hóa đúng bài toán, thay vì khiến cả đội phải vật lộn với những type quá thông minh. Một vài quy ước nhỏ có thể làm codebase ổn định, dễ đọc và dễ refactor hơn.

Những nguyên tắc thực tế

• Bật strict mode sớm và xử lý các điểm chưa an toàn.
• Ưu tiên type dễ đọc hơn type quá clever.
• Dùng union cho “một trong các trường hợp”, interface cho hình dạng dữ liệu ổn định.
• Tránh dùng any như đường tắt vì nó nhanh chóng trở thành nợ kỹ thuật.

Một pattern đáng nhớ

type Result<T> =
  | { ok: true; value: T }
  | { ok: false; error: string };

export function parseNumber(input: string): Result<number> {
  const value = Number(input);

  return Number.isFinite(value)
    ? { ok: true, value }
    : { ok: false, error: "Không phải là số hợp lệ" };
}

Kết

TypeScript tốt nên đọc giống tài liệu tốt: tên rõ ràng, cấu trúc dễ đoán và lỗi chỉ đúng nơi cần sửa.