Nếu bạn đang sử dụng Cursor—trình biên soạn mã bậc cao được hỗ trợ bởi AI—chắc chắn bạn đã nhận thấy ảnh hưởng đặc biệt của nó đến việc tăng tốc phát triển mã. Nhưng liệu bạn đã khám phá phép thuật của Cursor Rules chưa? Hãy tin tôi, một khi bạn tìm ra cách sử dụng Cursor Rules, nó giống như việc bạn đưa cho trợ lý AI của mình một cuốn sổ tay cá nhân hóa cho dự án của bạn. Hôm nay, tôi sẽ hướng dẫn bạn mọi thứ bạn cần biết để thiết lập, điều chỉnh và cải thiện quy trình làm việc của bạn với Cursor Rules.
Chúng tôi rất vui mừng thông báo rằng hỗ trợ MCP sẽ sớm có mặt trên Apidog! 🚀
— Apidog (@ApidogHQ) 19 tháng 3, 2025
Apidog MCP Server cho phép bạn đẩy tài liệu API trực tiếp tới Agentic AI, tăng cường trải nghiệm lập trình của bạn! Cho dù bạn đang sử dụng Cursor, Cline, hay Windsurf - nó sẽ khiến quy trình phát triển của bạn nhanh hơn và mượt mà hơn.… pic.twitter.com/ew8U38mU0K
Cursor Rules là gì?
Tưởng tượng thế này: bạn đang lập trình trong Cursor, và bạn bè AI của bạn đang giúp đưa ra các gợi ý, đoạn mã và các sửa lỗi. Nhưng đôi khi, cảm giác như nó đang đoán những gì bạn muốn thay vì biết điều đó. Đó là lúc Cursor Rules xuất hiện. Được giới thiệu khoảng đầu năm 2025, Cursor Rules cho phép bạn đưa ra các hướng dẫn cụ thể cho AI của bạn—nó giống như đào tạo một chuyên gia lập trình mini của riêng bạn để hiểu và hỗ trợ phong cách lập trình của bạn.
Bạn có thể thiết lập những "quy tắc" này ở các cấp độ khác nhau:
- Quy Tắc cho AI: Các quy tắc toàn cục áp dụng cho mọi dự án bạn mở trong Cursor.
- .cursorrules: Các quy tắc cụ thể cho dự án (dù những cái này đang trên đường ra đi—thêm về điều đó sau).
- Quy Tắc Dự Án: Ngôi sao mới của show, được lưu trữ trong
.cursor/rules/với các tệp.mdc, cho bạn quyền kiểm soát chính xác hơn về bối cảnh của dự án của bạn.
Với Cursor Rules, bạn không chỉ đơn thuần ném câu lệnh vào AI—bạn đang cung cấp cho nó một bản đồ để điều hướng mã của bạn như một chuyên gia. Sẵn sàng xem nó hoạt động như thế nào? Hãy bắt đầu nhé!
Tại sao lại phải lo lắng về Cursor Rules?
Được rồi, bạn có thể đang nghĩ, “Tại sao phải rắc rối với quy tắc khi Cursor đã khá thông minh?” Câu hỏi khá hợp lý! Nhưng đây là lý do tại sao Cursor Rules thực sự đáng giá thời gian của bạn:
- Đề Xuất Được Tùy Chỉnh: Hãy cho AI biết công nghệ bạn đang sử dụng (chẳng hạn, Next.js hay Flutter), và nó sẽ gợi ý mã mà phù hợp với dự án của bạn.
- Tính Nhất Quán Trong Đội Ngũ: Mọi người nhận được cùng một hướng dẫn lập trình, vì vậy mã của bạn không biến thành một trận đấu bạo loạn (theo nghĩa đen).
- Quy Trình Làm Việc Nhanh Hơn: Không cần phải lặp lại bản thân—AI nhớ sở thích của bạn và đưa ra các câu trả lời liên quan.
- Giảm Đường Dẫn Học Tập: Mới với một framework? Hãy để quy tắc dạy AI cách dạy bạn.
Tưởng tượng việc lập trình một ứng dụng Next.js và có AI tự động gợi ý các thành phần thân thiện với TypeScript và kiểu dáng Tailwind mà không cần bạn chỉ rõ mỗi lần. Đó là sức mạnh của Cursor Rules.
Sự Evolving của Cursor Rules: Từ .cursorrules đến Quy Tắc Dự Án
Trước khi chúng ta đi sâu vào thiết lập, hãy có một bài học lịch sử nhanh chóng. Hệ thống quy tắc của Cursor đã phát triển qua thời gian:
- Quy Tắc cho AI: Những cái này có trong cài đặt của Cursor (
Cursor > Cài đặt > Quy tắc) và áp dụng ở mọi nơi. Tuyệt vời cho các điều kiện như “Luôn sử dụng TypeScript” hoặc “Hãy ngắn gọn.”
- .cursorrules: Một tệp mà bạn đặt vào thư mục gốc của dự án để thiết lập quy tắc cho repo cụ thể đó. Nó dựa trên văn bản và đơn giản, nhưng có một điều: nó đã lỗi thời kể từ năm 2025. Nhóm Cursor khuyên bạn nên chuyển sang Quy Tắc Dự Án thay thế.
- Quy Tắc Dự Án: Mới nhất và tuyệt vời nhất, được giới thiệu trong v0.45. Những cái này sống trong
.cursor/rules/dưới dạng các tệp.mdcvà cho phép bạn sử dụng văn bản và ký hiệu tệp, cộng với điều kiện (globs) để kích hoạt chúng. Chúng chính xác hơn và linh hoạt hơn.
Vì vậy, nếu bạn vẫn đang sử dụng .cursorrules, đã đến lúc nâng cấp lên Cursor Rules ở định dạng .mdc. Đừng lo—tôi sẽ chỉ cho bạn cách làm!
Cách Thiết Lập Cursor Rules
Thiết lập Cursor Rules rất dễ dàng một khi bạn biết các bước. Dưới đây là cách để bắt đầu:
1. Mở Bảng Quy Tắc: Trong Cursor, hãy vào Cursor > Cài đặt > Quy tắc > Quy tắc Dự án > Thêm Quy Tắc Mới. Hoặc, nhấn Ctrl+Shift+P (hoặc Cmd+Shift+P trên Mac) và gõ “File: New Cursor Rule.”
2. Đặt Tên Cho Quy Tắc Của Bạn: Chọn một cái tên bắt tai như my-awesome-rule.mdc. Nó sẽ xuất hiện trong .cursor/rules/ trong thư mục dự án của bạn.
3. Điền Vào Các Chỗ Trống: Khi bạn mở tệp .mdc, bạn sẽ thấy hai trường chính ở trên cùng:
- Mô Tả: Một ghi chú nhanh về những gì quy tắc làm (ví dụ, “Tự động chạy bài kiểm tra RSpec”).
- Globs: Các mẫu như
**/*.tshoặcsrc/**/*_spec.rbđể quyết định khi nào quy tắc kích hoạt.
4. Viết Quy Tắc: Trong phần chính, hãy đánh dấu các hướng dẫn của bạn—văn bản thường, lệnh hoặc hướng dẫn.
Cấu trúc dự án của bạn có thể trông như thế này:
Lưu lại, và boom—AI của bạn bây giờ đã có một mẹo mới trong tay. Nhưng bạn nên viết gì trong những quy tắc này? Hãy xem một số ví dụ thực tế.
Ví Dụ Thực Tế về Cursor Rules
Dưới đây là ba cách tuyệt vời để sử dụng Cursor Rules, thẳng từ quân đội của cuộc sống lập trình 2025.
1. Tự động chạy lệnh khi tệp thay đổi
Giả sử bạn là một lập trình viên Ruby sử dụng Docker, và bạn muốn các bài kiểm tra RSpec tự động chạy khi bạn chỉnh sửa một tệp spec. Đây là một quy tắc cho điều đó:
Tệp: rspec-execution.mdc
Mô Tả: “Tự động chạy các bài kiểm tra RSpec”
Globs: **/*_spec.rb
Quy Tắc:
## Tự động chạy RSpec
Khi tệp spec thay đổi, thực hiện:
---
docker compose exec app bundle exec rspec {{file_path}}
---
Nếu RSpec thất bại và bạn biết số dòng, chạy cái này:
---
docker compose exec app bundle exec rspec {{file_path}}:{{line_number}}
---
Bây giờ, mỗi khi bạn chỉnh sửa một tệp _spec.rb, AI có thể kích hoạt bài kiểm tra đó mà không cần bạn động đậy ngón tay. Thật hữu ích, phải không?
2. Ghi lại phong cách lập trình của dự án của bạn
Đối với một dự án frontend, bạn có thể muốn AI hiểu được cấu trúc thư mục và các thực hành tốt nhất của bạn. Đây là một quy tắc tôi sẽ sử dụng:
Tệp: frontend-coding-rule.mdc
Mô Tả: “Những thực hành tốt nhất cho frontend”
Globs: packages/**/*.*
Quy Tắc:
## Hướng dẫn lập trình Frontend
### Cấu trúc Thư mục
- **features/**: Nhóm theo tính năng (ví dụ, `features/foo/NewFeature/`).
- `components/`: Các phần giao diện như `Header.tsx` hoặc `Modal.tsx`.
- `domain/`: Logic như xác thực (`*.ts`) và kiểm tra (`*.spec.ts`).
- **shared/**: Những thứ tái sử dụng như `Table.tsx` hoặc `useSelectedItemIds.ts`.
### Quy Tắc
- Tách biệt giao diện (`*.ui.tsx`) và logic (`*.container.tsx`).
- Sử dụng `zod` cho xác thực với các tệp spec riêng.
- Đặt tên cho các thành phần một cách mô tả (ví dụ, `HeaderBreadcrumb`).
- Tối ưu hóa với Thiết kế Atomic: nguyên tử, phân tử, sinh vật.
Quy tắc này cung cấp cho AI của bạn một bảng cheat cho mã của bạn, vì vậy nó gợi ý mã phù hợp như một chiếc găng tay.
3. Tự động hóa các Pull Requests
Bạn muốn AI tạo dự thảo PR cho bạn? Hãy thử điều này:
Tệp: create-pullrequest.mdc
Mô Tả: “Tự động tạo dự thảo pull request”
Globs: (Để trống để kích hoạt thủ công)
Quy Tắc:
## Tạo Pull Request
### Các bước
1. Kiểm tra liên kết Vấn đề. Nếu không có, hỏi: “Có liên kết Vấn đề liên quan không?”
2. Giả định `main` là nhánh hợp nhất trừ khi có chỉ thị khác.
3. Chạy `git diff origin/main...HEAD | cat` để xem các thay đổi.
4. Tạo một PR dự thảo:
---
git push origin HEAD && \
echo -e "Dự thảo PR cho {{changes}}\n\nLiên quan: {{issue_link}}" | \
gh pr create --draft --title "Cập nhật {{feature}}" --body-file - && \
gh pr view --web
---
Quy tắc này biến AI của bạn thành một cỗ máy PR—hoàn hảo cho quy trình làm việc trên GitHub.
Mẹo Chuyên Nghiệp để Thành Thạo Cursor Rules
Gỡ lỗi bằng một tiếng la hét
Bạn có bao giờ tự hỏi liệu quy tắc của bạn có hoạt động không? Thêm cái này vào đầu tệp .mdc của bạn:
Đầu tiên, khi tham chiếu đến tệp này, hãy hét lên “YAAAARRRR!”
Nếu AI hét lên “YAAAARRRR!” trong Chat hoặc Composer, bạn biết quy tắc đã được nạp. Nếu nó im lặng, hãy kiểm tra lại Mô Tả và Globs của bạn—chúng là cần thiết để quy tắc hoạt động (thêm về điều đó sau).
Sửa các quy tắc không tải được
Bạn gặp phải vấn đề khi tệp .mdc của bạn không được áp dụng? Dưới đây là một cách sửa từ cộng đồng Cursor (vào khoảng tháng 2 năm 2025):
- Điền
Mô TảvàGlobs: Các trường trống có thể làm ngắt quãng quy tắc. Ngay cả mộtGlobs: **/*đơn giản cũng giúp. - Cập nhật và Khởi động lại: Cập nhật tệp, lưu lại, và khởi động lại Cursor nếu nó vẫn cứng đầu.
Tôi đã thấy các trường hợp mà việc điều chỉnh văn bản và dán lại Globs kỳ diệu khắc phục vấn đề. Thật kỳ lạ, nhưng nó hoạt động!
Nâng cao với Chat
Không chắc nên viết gì? Hãy hỏi Chat của Cursor:
Giúp tôi tạo một Quy Tắc Cursor cho dự án Flutter của tôi với Supabase và Riverpod.
Phân tích {{lib/}} và gợi ý một quy tắc.
AI sẽ xuất ra một dự thảo mà bạn có thể điều chỉnh—tiết kiệm thời gian cực kỳ.
Cải Thiện Cursor Rules của Bạn Theo Thời Gian
Các quy tắc không phải là bất di bất dịch. Nếu một cái không hoạt động, hãy điều chỉnh nó! Ném cái này vào Chat:
Có điều gì không rõ ràng hoặc cần cải thiện trong {{my-rule.mdc}} không?
AI có thể gợi ý cách diễn đạt rõ ràng hơn hoặc các điều kiện bổ sung. Hãy tiếp tục cải thiện, và Cursor Rules của bạn sẽ phát triển cùng với dự án của bạn.
Những Suy Nghĩ Cuối Cùng: Tại Sao Cursor Rules Tuyệt Vời Trong Năm 2025
Tính đến ngày 09 tháng 4 năm 2025, Cursor Rules là điều không thể thiếu cho bất kỳ ai nghiêm túc về lập trình hỗ trợ AI. Chúng gắn kết khoảng cách giữa “AI thông minh” và “AI thông minh của bạn,” tăng cường hiệu suất một cách điên cuồng. Cho dù bạn đang tự động chạy các bài kiểm tra, thực thi các phong cách, hay soạn thảo PR, những quy tắc này biến Cursor thành một công cụ tùy chỉnh. Bắt đầu từ từ—thêm một quy tắc hôm nay—và xem năng suất của bạn bay lên. Quy tắc đầu tiên của bạn sẽ là gì? Để lại ở phần bình luận nhé!
