Hướng dẫn thiết lập quy tắc trên Cursor

Cursor hiện tại đang dần vươn lên trở thành công cụ Code Editor dẫn đầu nhờ khả năng hiểu sâu mã nguồn dự án. Một trong những tính năng mạnh mẽ nhất nhưng thường bị người dùng mới bỏ qua chính là Cursor Rules. Việc thiết lập các quy tắc này giúp AI không chỉ viết code đúng cú pháp mà còn tuân thủ đúng phong cách lập trình (coding convention), cấu trúc thư mục và các thư viện đặc thù dành riêng cho bạn.

Bài viết này sẽ hướng dẫn bạn cách làm chủ các tệp .mdc để biến Cursor thành một cộng sự thực thụ, hiểu ý bạn đến từng dòng code.

Cursor Rules là gì và tại sao nó quan trọng?

Trước khi đi vào các bước thực hiện, chúng ta cần hiểu bản chất của Cursor Rules. Về cơ bản, đây là những chỉ dẫn (instructions) được lưu trữ dưới định dạng Markdown đặc biệt (.mdc). Các tệp này nằm trong thư mục .cursor/rules/ của dự án.

Khi bạn đặt quy tắc, AI của Cursor (như Claude 4.5 Sonnet hoặc GPT-5) sẽ ưu tiên đọc các tệp này trước khi đưa ra câu trả lời. Điều này giải quyết triệt để vấn đề AI thường xuyên đề xuất các đoạn code lỗi thời hoặc không phù hợp với cấu trúc mà công ty bạn đang áp dụng.

3 Cách tạo Cursor Rules mới nhất năm 2026

Hiện tại, Cursor đã đơn giản hóa quy trình tạo quy tắc để người dùng không cần phải am hiểu sâu về cấu trúc Metadata vẫn có thể thực hiện được.

Cách 1: Sử dụng lệnh Chat tự động (Khuyên dùng)

Đây là cách nhanh nhất và thông minh nhất vì AI sẽ tự dự đoán các Metadata cần thiết dựa trên yêu cầu của bạn.

Bước 1: Mở dự án: Khởi động ứng dụng Cursor và mở thư mục dự án của bạn (File > Open Folder).

Chọn Folder bạn muốn đưa vào Cursor.

Bước 2: Mở khung Chat: Nhấn tổ hợp phím Ctrl + L (Windows/Linux) hoặc Cmd + L (Mac) để kích hoạt bảng điều khiển AI Chat ở phía bên phải. Bảng điều khiển này cũng có thể nằm ở vị trí khác trong giao diện của Cursor.

Bước 3: Nhập lệnh: Gõ câu lệnh theo cấu trúc: /create-rule [nội dung quy tắc].

Ví dụ:

/create-rule Luôn sử dụng Tailwind CSS cho các thành phần UI và ưu tiên dùng Lucide React cho icon.

Bước 4: Xác nhận: Nhấn Enter. Cursor AI sẽ tự động tạo một tệp mới trong thư mục .cursor/rules/ với tên tệp chuẩn hóa và phần Header Metadata (bao gồm tên quy tắc, mô tả và các file pattern bị ảnh hưởng).

Bước 5: Lưu quy tắc:

Click vào nút Review trên giao diện chat để kiểm tra nội dung, bạn có thể yêu cầu thêm dựa theo gợi ý của Cursor. Quy tắc được tạo ra sẽ tự động lưu lại trong thư mục mà bạn đã mở từ bước 1.

Cách 2: Sử dụng Command Palette

Nếu bạn là người thích sử dụng phím tắt để tối ưu tốc độ làm việc:

1. Nhấn Ctrl + Shift + P (Windows/Linux) hoặc Cmd + Shift + P (Mac).
2. Gõ từ khóa "Cursor Rules: Create New Rule".
3. Cursor sẽ mở ra một giao diện soạn thảo tệp .mdc trống với các gợi ý về cấu trúc Metadata. Bạn chỉ cần điền thông tin và lưu lại.

Cách 3: Tạo thủ công bằng tay

Cách này dành cho các kỹ sư muốn kiểm soát 100% cấu trúc của quy tắc:

1. Tạo một thư mục có tên .cursor ở thư mục gốc (root) của dự án (nếu chưa có).
2. Bên trong thư mục đó, tạo tiếp thư mục con tên là rules.
3. Tạo một tệp mới có định dạng .mdc. Ví dụ: typescript-standard.mdc.
4. Viết nội dung theo cấu trúc:

---
description: Quy tắc dành cho các file TypeScript
globs: **/*.ts, **/*.tsx
---
# Nội dung quy tắc tại đây
- Sử dụng Interface thay vì Type cho các định nghĩa Object.
- Luôn export tường minh các hàm xử lý logic.

Cấu trúc chuẩn của một tệp .mdc chuyên nghiệp

Một tệp Cursor Rule hiệu quả không chỉ là một danh sách các câu lệnh. Nó cần có cấu trúc để AI hiểu khi nào cần kích hoạt quy tắc đó.

• Phần Frontmatter (Metadata): Nằm giữa hai dấu ---.

  • description: Giải thích ngắn gọn mục đích của quy tắc.

  • globs: Chỉ định các loại tệp tin mà quy tắc này áp dụng (ví dụ: src/components/*.tsx).

• Phần Nội dung (Markdown): Sử dụng các thẻ H1, H2 và dấu gạch đầu dòng để phân cấp chỉ dẫn. Bạn nên cung cấp cả ví dụ "Nên làm" (Good) và "Không nên làm" (Bad) để AI bắt chước chính xác hơn.

Cách tối ưu hóa Cursor Rules cho dự án lớn

Khi dự án của bạn phình to với hàng trăm tệp tin, việc có quá nhiều quy tắc chồng chéo có thể khiến AI bị "loạn". Dưới đây là chiến lược quản lý:

Phân loại quy tắc theo phạm vi (Scope)

Thay vì tạo một tệp quy tắc khổng lồ cho toàn bộ dự án, hãy chia nhỏ chúng:

• Global Rules: Các quy tắc về ngôn ngữ (ví dụ: Strict TypeScript).
• Feature Rules: Quy tắc riêng cho từng tính năng (ví dụ: Quy tắc xử lý thanh toán, quy tắc xác thực người dùng).
• Library Rules: Chỉ dẫn riêng khi làm việc với các thư viện bên thứ ba như ShadcnUI, Redux hoặc Prisma.

Sử dụng tính năng "Context Mention"

Trong phiên bản Cursor 2026, bạn có thể nhắc đến một quy tắc cụ thể trong lúc chat bằng cách gõ ký tự @ và chọn tên quy tắc đó. Điều này giúp bạn ép AI phải tuân thủ một tiêu chuẩn cụ thể cho một đoạn code nhạy cảm mà không cần nó phải quét toàn bộ các quy tắc khác.

Những sai lầm thường gặp khi thiết lập Cursor Rules

Dù rất mạnh mẽ, nhưng nếu thiết lập sai, Cursor Rules có thể trở thành "con dao hai lưỡi" làm chậm tiến độ của bạn:

1. Quy tắc quá mơ hồ: Những câu lệnh như "Viết code sạch" hoặc "Tối ưu hiệu năng" thường không có tác dụng. Hãy cụ thể hóa bằng các chỉ dẫn định lượng như "Hàm không được quá 30 dòng" hoặc "Luôn sử dụng useCallback cho các hàm truyền vào memoized component".
2. Xung đột Globs: Khi hai tệp quy tắc cùng áp dụng cho một file nhưng lại đưa ra chỉ dẫn trái ngược nhau. Cursor sẽ ưu tiên tệp có metadata cụ thể hơn, nhưng tốt nhất bạn nên kiểm tra kỹ phần globs.
3. Quên cập nhật quy tắc: Khi công nghệ thay đổi (ví dụ: nâng cấp từ Next.js 14 lên phiên bản mới hơn), hãy nhớ cập nhật tệp .mdc. AI sẽ không tự biết kiến thức cũ trong quy tắc của bạn đã lỗi thời trừ khi bạn sửa nó.