Giao diện và thiết lập Cursor AI

Cài đặt Cursor, nhập cài đặt VS Code, hiểu bố cục giao diện, cấu hình lập chỉ mục và thiết lập .cursorignore cho các dự án của bạn.

Bắt đầu

Cursor có sẵn cho Mac, Windows và Linux. Tải xuống từ cursor.com, chạy trình cài đặt và bạn đã sẵn sàng trong khoảng 2 phút.

Nhưng trước khi bắt đầu lập trình, có một vài bước thiết lập thực sự tạo nên sự khác biệt về hiệu quả hoạt động của Cursor. Bỏ qua chúng, và bạn sẽ tự hỏi tại sao AI lại đưa ra những gợi ý kỳ lạ. Làm đúng các bước này, và Cursor sẽ hoạt động như thể nó thực sự hiểu dự án của bạn.

Cài đặt và chuyển đổi từ VS Code

Nếu bạn đang chuyển từ VS Code (hầu hết mọi người đều vậy), quá trình chuyển đổi gần như tức thì:

1. Mở Cursor Settings: Nhấn Cmd+Shift+J (Mac) hoặc Ctrl+Shift+J (Windows)
2. Đi đến General > Account
3. Nhấp vào Import bên dưới VS Code Import

Cursor sẽ quét cài đặt VS Code của bạn và lấy các extension, theme, phím tắt và cài đặt của bạn. Đối với khoảng 80% người dùng, mọi thứ được chuyển đổi hoàn hảo.

Những gì có thể không được chuyển đổi:

• Các extension độc quyền của Microsoft — Ví dụ: C# Dev Kit chỉ dành riêng cho VS Code. Hãy sử dụng các lựa chọn thay thế từ cộng đồng như OmniSharp
• Cài đặt VS Code Insiders — Đôi khi Cursor tìm kiếm trong thư mục sai. Bạn có thể cần phải trỏ thủ công đến thư mục cấu hình Insiders của mình
• Extension SSH/DevContainer từ xa — Những tiện ích này không phải lúc nào cũng tự động di chuyển

✅ Kiểm tra nhanh: Bạn đã cài đặt Cursor nhưng theme VS Code yêu thích của bạn không được nhập. Cách khắc phục khả dĩ nhất là gì? Đi đến bảng Extensions (Cmd+Shift+X), tìm kiếm theme của bạn theo tên và cài đặt nó. Hầu hết các theme đều là mã nguồn mở và có sẵn trong chợ extension của Cursor. Nếu nó có trong VS Code, thì gần như chắc chắn nó cũng có trong Cursor.

Bố cục giao diện

Cursor trông giống như VS Code — có chủ ý. Nhưng có một vài tính năng bổ sung mà bạn nên biết:

Các mục quen thuộc:

• Trình quản lý file (thanh bên trái)
• Bảng chỉnh sửa (ở giữa)
• Cửa sổ dòng lệnh (dưới cùng)
• Extension, quản lý nguồn, tìm kiếm (thanh hoạt động bên trái)

Các tính năng bổ sung:

• Bảng AI Chat — Thanh bên phải. Mở bằng Cmd+L. Đây là nơi bạn trò chuyện với AI về code của mình -
• Composer — Mở bằng Cmd+I. Đây là nơi diễn ra chế độ Agent và chỉnh sửa nhiều file
• Dự đoán tab — Hiển thị ngay khi bạn gõ. Không chỉ là tự động hoàn thành — nó còn dự đoán chỉnh sửa tiếp theo của bạn

Các phím tắt bạn sẽ sử dụng nhiều nhất:

Bạn không cần phải ghi nhớ tất cả những điều này ngay bây giờ. Chúng ta sẽ tìm hiểu chi tiết từng phần trong các bài học sau.

Lập chỉ mục: Cách Cursor hiểu dự án của bạn

Khi bạn mở thư mục dự án lần đầu tiên trong Cursor, nó sẽ lập chỉ mục codebase của bạn. Đây là bước phân biệt Cursor với một trình soạn thảo thông thường có tích hợp trí tuệ nhân tạo.

Việc lập chỉ mục làm gì: Nó xây dựng một bản đồ ngữ nghĩa cho code của bạn — các hàm, lớp, những lệnh nhập, mối quan hệ giữa các file. Điều này hỗ trợ các tính năng như tìm kiếm @Codebase, nơi bạn có thể hỏi "Cơ chế xác thực hoạt động như thế nào trong dự án này?" và nhận được câu trả lời tham chiếu đến những file phù hợp.

Thời gian thực hiện: Vài giây đối với các dự án nhỏ. Một hoặc hai phút đối với các codebase lớn (trên 100.000 dòng). Bạn sẽ thấy chỉ báo tiến độ trên thanh trạng thái.

Những điều cần biết:

• Việc lập chỉ mục diễn ra tự động khi bạn mở một thư mục
• Nó sẽ lập chỉ mục lại khi các file thay đổi
• Bạn có thể kích hoạt lập chỉ mục lại thủ công từ Cursor Settings nếu thấy có gì đó không ổn
• Các file nhị phân lớn, node_modules và đầu ra bản build được loại trừ theo mặc định

Bảo vệ các file nhạy cảm

Đây là bước thiết lập mà hầu hết mọi người bỏ qua — và nó rất quan trọng.

Khi Cursor lập chỉ mục dự án của bạn và gửi ngữ cảnh đến các mô hình AI, nó có thể bao gồm nội dung file. Bạn không muốn API key, mật khẩu cơ sở dữ liệu hoặc bí mật khách hàng của mình bị gửi đến máy chủ của OpenAI hoặc Anthropic.

Tạo một file .cursorignore trong thư mục gốc dự án của bạn:

📍 Nơi dán: Mở ChatGPT (chat.openai.com), Claude (claude.ai) hoặc Gemini (gemini.google.com) và bắt đầu một cuộc trò chuyện mới.

📋 Cách sao chép prompt này: Nhấp vào bất kỳ đâu bên trong khối màu xám, nhấn Cmd+A sau đó Cmd+C (Mac) hoặc Ctrl+A sau đó Ctrl+C (Windows). Hoặc sử dụng biểu tượng sao chép xuất hiện.

# Các file nhạy cảm
.env
.env.*
*.pem
*.key
credentials.json
secrets/

# Các file lớn gây lãng phí ngữ cảnh
node_modules/
dist/
build/
*.min.js

✏️ ​​Cách điền thông tin chi tiết của bạn: Thay thế mỗi dấu ngoặc vuông [] và trình giữ chỗ trong ngoặc bằng thông tin cụ thể từ tình huống thực tế của bạn. Thông tin đầu vào mơ hồ sẽ tạo ra kết quả đầu ra mơ hồ — hãy cụ thể.

👀 Những gì bạn sẽ thấy: Trong vòng vài giây, AI sẽ trả về một phản hồi có cấu trúc dựa trên lời nhắc ở trên. Hãy đọc kỹ và coi đó là bản nháp, không phải là câu trả lời cuối cùng.

📌 Nên làm gì với kết quả đầu ra: Lưu phản hồi vào file Notes. Chọn đề xuất có tác động cao nhất và thực hiện nó trong tuần này — đừng cố gắng làm mọi thứ cùng một lúc.

⚠️ Nếu thấy không ổn: Nếu các đề xuất có vẻ chung chung, hãy dán nội dung sau: "Hãy cụ thể hơn với ngữ cảnh thực tế của tôi. Bỏ những lời khuyên chung chung đi." Nếu bỏ qua các chi tiết quan trọng bạn đã cung cấp, hãy hỏi: "Bạn đã bỏ sót [X] trong ngữ cảnh của tôi — hãy thực hiện lại với điều đó làm ràng buộc chính."

File này hoạt động giống như .gitignore. Bất cứ thứ gì được liệt kê ở đây sẽ không được lập chỉ mục hoặc gửi dưới dạng ngữ cảnh AI. Cursor nỗ lực hết sức để ngăn chặn việc lộ các file này.

Cũng có .cursorindexignore — cú pháp tương tự, nhưng nó chỉ ngăn chặn việc lập chỉ mục. AI vẫn có thể thấy các file nếu bạn tham chiếu chúng một cách rõ ràng. Sử dụng .cursorignore cho các file thực sự nhạy cảm và .cursorindexignore cho những file bạn hiếm khi cần (như thư mục docs/ lớn).

Các cài đặt quan trọng

Một vài cài đặt đáng điều chỉnh sớm:

Privacy Mode (Settings > General > Privacy): Khi được bật, không có code plaintext nào được lưu trữ trên máy chủ của Cursor. Cursor có thỏa thuận không lưu trữ dữ liệu với các nhà cung cấp AI ở chế độ này. Nếu bạn làm việc với code nhạy cảm, hãy bật tính năng này.

Codebase Indexing (Settings > Features > Codebase Indexing): Nên được bật theo mặc định. Nếu tìm kiếm @Codebase không trả về kết quả nào, hãy kiểm tra cài đặt này.

Tab Completion (Settings > Features > Cursor Tab): Điều khiển hành vi tự động hoàn thành của AI. Bạn có thể điều chỉnh mức độ gợi ý và liệu nó có hiển thị dự đoán nhiều dòng hay không.

Những điểm chính cần lưu ý

• Nhập cài đặt VS Code chỉ với một cú nhấp chuột (Cmd+Shift+J) — hầu hết các extension được chuyển ngay lập tức
• Giao diện của Cursor là VS Code cộng với AI Chat (Cmd+L), Composer (Cmd+I) và dự đoán bằng phím Tab
• Lập chỉ mục xây dựng bản đồ ngữ nghĩa của codebase — đó là điều giúp tìm kiếm @Codebase hoạt động
• Tạo file .cursorignore để bảo vệ API key, thông tin đăng nhập và các file nhạy cảm khỏi ngữ cảnh AI
• Bật Privacy Mode nếu bạn làm việc với code nhạy cảm hoặc độc quyền